Condividi tramite


IDTSVirtualInput100 Interfaccia

Definizione

Rappresenta le colonne disponibili per un componente dal componente a monte.

public interface class IDTSVirtualInput100 : Microsoft::SqlServer::Dts::Pipeline::Wrapper::IDTSObject100
[System.Runtime.InteropServices.Guid("FECB6DEB-654E-43EE-B87D-35F88555172E")]
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)]
public interface IDTSVirtualInput100 : Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSObject100
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)]
[System.Runtime.InteropServices.Guid("3D8056A8-CA41-48E4-A3C2-74542DF68634")]
public interface IDTSVirtualInput100 : Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSObject100
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)]
[System.Runtime.InteropServices.Guid("937BE9E1-F78D-4582-92EC-355CCF399702")]
public interface IDTSVirtualInput100 : Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSObject100
[<System.Runtime.InteropServices.Guid("FECB6DEB-654E-43EE-B87D-35F88555172E")>]
[<System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)>]
type IDTSVirtualInput100 = interface
    interface IDTSObject100
[<System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)>]
[<System.Runtime.InteropServices.Guid("3D8056A8-CA41-48E4-A3C2-74542DF68634")>]
type IDTSVirtualInput100 = interface
    interface IDTSObject100
[<System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)>]
[<System.Runtime.InteropServices.Guid("937BE9E1-F78D-4582-92EC-355CCF399702")>]
type IDTSVirtualInput100 = interface
    interface IDTSObject100
Public Interface IDTSVirtualInput100
Implements IDTSObject100
Attributi
Implementazioni

Esempio

Nell'esempio di codice seguente viene illustrato come usare l'input virtuale per selezionare le colonne usate da un componente durante la compilazione a livello di codice dell'attività flusso di dati.

public void SelectColumns(IDTSComponentMetaData100 md)  
{  
    // Create the design time instance of the component.  
    CManagedComponentWrapper wrp = md.Instantiate();  

    // Walk the input collection.  
    foreach (IDTSInput100 input in md.InputCollection)  
    {  
        // Get the virtual input columns.  
        IDTSVirtualInput100 vInput = input.GetVirtualInput();  

        // For each virtual column, set its usagetype to READONLY.  
        foreach (IDTSVirtualInputColumn100 vCol in vInput.VirtualInputColumnCollection)  
            wrp.SetUsageType(input.ID, vInput, vCol.LineageID, DTSUsageType.UT_READONLY);  
    }  
}  
Public Sub SelectColumns(ByVal md As IDTSComponentMetaData100)   
 Dim wrp As CManagedComponentWrapper = md.Instantiate   
 For Each input As IDTSInput100 In md.InputCollection   
   Dim vInput As IDTSVirtualInput100 = input.GetVirtualInput   
   For Each vCol As IDTSVirtualInputColumn100 In vInput.VirtualInputColumnCollection   
     wrp.SetUsageType(input.ID, vInput, vCol.LineageID, DTSUsageType.UT_READONLY)   
   Next   
 Next   
End Sub  

Nell'esempio di codice seguente viene illustrato un componente del flusso di dati personalizzato che seleziona tutte le colonne DT_STR dall'input virtuale quando l'input è connesso a un percorso.

public override void OnInputPathAttached(int inputID)  
{  
    IDTSInput100 input = ComponentMetaData.InputCollection.GetObjectByID(inputID);  
    IDTSVirtualInput100 vInput = input.GetVirtualInput();  

    foreach (IDTSVirtualInputColumn100 vCol in vInput.VirtualInputColumnCollection)  
    {  
        if (vCol.DataType == DataType.DT_STR)  
        {  
            this.SetUsageType(inputID, vInput, vCol.LineageID, DTSUsageType.UT_READONLY);  
        }  
    }  
}  
Public Overrides Sub OnInputPathAttached(ByVal inputID As Integer)   
 Dim input As IDTSInput100 = ComponentMetaData.InputCollection.GetObjectByID(inputID)   
 Dim vInput As IDTSVirtualInput100 = input.GetVirtualInput   
 For Each vCol As IDTSVirtualInputColumn100 In vInput.VirtualInputColumnCollection   
   If vCol.DataType = DataType.DT_STR Then   
     Me.SetUsageType(inputID, vInput, vCol.LineageID, DTSUsageType.UT_READONLY)   
   End If   
 Next   
End Sub  

Commenti

Viene IDTSVirtualInput100 recuperato chiamando il GetVirtualInput metodo di un IDTSInput100 oggetto. La VirtualInputColumnCollection proprietà contiene le colonne disponibili dai componenti upstream nel grafico.

Quando si compila a livello di codice un'attività flusso di dati, le colonne virtuali vengono selezionate per un componente chiamando il SetUsageType metodo di CManagedComponentWrapperClass.

Gli sviluppatori che scrivono componenti del flusso di dati personalizzati usano l'input virtuale per individuare le colonne upstream disponibili e, a seconda del componente, per aggiungere colonne all'input in base alle colonne della raccolta virtuale.

Poiché l'input virtuale è una riflessione delle colonne upstream, le modifiche apportate all'input virtuale o alle colonne della raccolta di input virtuale non hanno alcun impatto sulla IDTSOutput100 stessa.

Proprietà

Description

Ottiene o imposta la descrizione di un oggetto IDTSVirtualInput100.

ID

Ottiene o imposta l'ID di un oggetto di input virtuale.

IdentificationString

Ottiene una stringa che identifica in modo univoco l'oggetto IDTSVirtualInput100.

IsSorted

Ottiene un valore che indica se le colonne di input virtuali nell'oggetto IDTSVirtualInput100 vengono ordinate.

Name

Ottiene o imposta il nome di un oggetto IDTSVirtualInput100.

ObjectType

Ottiene l'oggetto DTSObjectType di un oggetto IDTSVirtualInput100.

SourceLocale

Ottiene l'ID delle impostazioni locali (LCID) dell'origine dell'oggetto IDTSVirtualInput100.

VirtualInputColumnCollection

Ottiene l'oggetto IDTSVirtualInputColumnCollection100 di un oggetto IDTSVirtualInput100.

Metodi

SetUsageType(Int32, DTSUsageType)

Esegue il mapping di un oggetto della colonna di input virtuale e ne imposta il tipo di utilizzo.

Si applica a