IDTSVirtualInput100 Schnittstelle

Definition

Namespace:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

Assembly:

Microsoft.SqlServer.DTSPipelineWrap.dll

Repräsentiert die Spalten, die einer Komponente von der vorgelagerten Komponente zur Verfügung stehen.

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

Attribute

GuidAttribute TypeLibTypeAttribute

Implementiert

IDTSObject100

Beispiele

Das folgende Codebeispiel zeigt, wie man die virtuelle Eingabe verwendet, um die Spalten auszuwählen, die von einer Komponente beim programmatischen Erstellen der Datenflussaufgabe verwendet werden.

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  

Das folgende Codebeispiel zeigt eine benutzerdefinierte Datenflusskomponente, die alle DT_STR Spalten aus der virtuellen Eingabe auswählt, wenn die Eingabe mit einem Pfad verbunden ist.

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  

Hinweise

Die wird abgerufen, indem die IDTSVirtualInput100 Methode GetVirtualInput eines Objekts IDTSInput100 aufgerufen wird. Die Eigenschaft VirtualInputColumnCollection enthält die Spalten, die von den vorgelagerten Komponenten im Graphen verfügbar sind.

Beim programmatischen Erstellen einer Datenflussaufgabe werden die virtuellen Spalten für eine Komponente ausgewählt, indem die Methode SetUsageType der Methode aufgerufen wird CManagedComponentWrapperClass.

Entwickler, die benutzerdefinierte Datenflusskomponenten schreiben, verwenden die virtuelle Eingabe, um die verfügbaren Upstream-Spalten zu entdecken, und je nach Komponente Spalten zur Eingabe basierend auf den Spalten in der virtuellen Sammlung hinzuzufügen.

Da die virtuelle Eingabe eine Spiegelung der vorgelagerten Spalten ist, haben Änderungen an der virtuellen Eingabe oder an den Spalten in der virtuellen Eingabesammlung keinen Einfluss auf die Spalte IDTSOutput100 selbst.

Eigenschaften

Name	Beschreibung
Description	Erhält oder setzt die Beschreibung eines IDTSVirtualInput100 Objekts.
ID	Erhält oder setzt die ID eines virtuellen Eingabeobjekts.
IdentificationString	Erhält eine Zeichenkette, die die eindeutig identifiziert.IDTSVirtualInput100
IsSorted	Erhält einen Wert, der angibt, ob die virtuellen Eingabespalten in der sortiert IDTSVirtualInput100 sind.
Name	Erhält oder setzt den Namen eines IDTSVirtualInput100.
ObjectType	Bekommt das von DTSObjectType einem IDTSVirtualInput100.
SourceLocale	Erhält die Lokalisierungs-ID (LCID) der Quelle des IDTSVirtualInput100.
VirtualInputColumnCollection	Bekommt das von IDTSVirtualInputColumnCollection100 einem IDTSVirtualInput100.

Methoden

Name	Beschreibung
SetUsageType(Int32, DTSUsageType)	Bildet ein virtuelles Eingabespaltenobjekt ab und legt dessen Nutzungstyp fest.