IDTSVirtualInput100 Interfaccia

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014

Assembly:

Microsoft.SqlServer.DTSPipelineWrap.dll

public interface class IDTSVirtualInput100 : Microsoft::SqlServer::Dts::Pipeline::Wrapper::Sql2014::IDTSObject100

[System.Runtime.InteropServices.Guid("DD9E7F1F-A112-4EBD-9178-EE7DB0F2EDEC")]
[System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)]
public interface IDTSVirtualInput100 : Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014.IDTSObject100

[<System.Runtime.InteropServices.Guid("DD9E7F1F-A112-4EBD-9178-EE7DB0F2EDEC")>]
[<System.Runtime.InteropServices.TypeLibType(System.Runtime.InteropServices.TypeLibTypeFlags.FDispatchable | System.Runtime.InteropServices.TypeLibTypeFlags.FDual)>]
type IDTSVirtualInput100 = interface
    interface IDTSObject100

Public Interface IDTSVirtualInput100
Implements IDTSObject100

Attributi

GuidAttribute TypeLibTypeAttribute

Implementazioni

IDTSObject100

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 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  

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);  
    }  
}  

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

L'IDTSVirtualInput100 viene 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

ID

IdentificationString

IsSorted

Name

ObjectType

SourceLocale

VirtualInputColumnCollection

Metodi

SetUsageType(Int32, DTSUsageType)