IDTSVirtualInput100 Interfaccia

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

Assembly:

Microsoft.SqlServer.DTSPipelineWrap.dll

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

public interface class 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.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

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