IDTSVirtualInput100 Antarmuka

Definisi

Ruang nama:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

Rakitan:

Microsoft.SqlServer.DTSPipelineWrap.dll

Mewakili kolom yang tersedia untuk komponen dari komponen upstram.

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

Atribut

GuidAttribute TypeLibTypeAttribute

Penerapan

IDTSObject100

Contoh

Contoh kode berikut menunjukkan cara menggunakan input virtual untuk memilih kolom yang digunakan oleh komponen saat membangun tugas aliran data secara terprogram.

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  

Contoh kode berikut menunjukkan komponen aliran data kustom yang memilih semua kolom DT_STR dari input virtual saat input tersambung ke jalur.

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  

Keterangan

IDTSVirtualInput100 diambil dengan memanggil GetVirtualInput metode IDTSInput100 objek . Properti VirtualInputColumnCollection berisi kolom yang tersedia dari komponen upstram dalam grafik.

Saat membangun tugas aliran data secara terprogram, kolom virtual dipilih untuk komponen dengan memanggil SetUsageType metode CManagedComponentWrapperClass.

Pengembang yang menulis komponen aliran data kustom menggunakan input virtual untuk menemukan kolom hulu yang tersedia, dan, tergantung pada komponen, untuk menambahkan kolom ke input berdasarkan kolom dalam koleksi virtual.

Karena input virtual adalah refleksi kolom hulu, modifikasi pada input virtual atau kolom dalam koleksi input virtual tidak berdampak pada IDTSOutput100 dirinya sendiri.

Properti

Description	Mendapatkan atau mengatur deskripsi IDTSVirtualInput100 objek.
ID	Mendapatkan atau mengatur ID objek input virtual.
IdentificationString	Mendapatkan string yang secara unik mengidentifikasi IDTSVirtualInput100.
IsSorted	Mendapatkan nilai yang menunjukkan apakah kolom input virtual diurutkan IDTSVirtualInput100 .
Name	Mendapatkan atau menetapkan nama IDTSVirtualInput100.
ObjectType	DTSObjectType Mendapatkan dari IDTSVirtualInput100.
SourceLocale	Mendapatkan ID lokal (LCID) dari IDTSVirtualInput100sumber .
VirtualInputColumnCollection	IDTSVirtualInputColumnCollection100 Mendapatkan dari IDTSVirtualInput100.

Metode

SetUsageType(Int32, DTSUsageType)

Memetakan objek kolom input virtual dan mengatur jenis penggunaannya.