IDTSVirtualInput100 인터페이스

정의

네임스페이스:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

어셈블리:

Microsoft.SqlServer.DTSPipelineWrap.dll

업스트림 구성 요소에서 구성 요소에 사용할 수 있는 열을 나타냅니다.

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

특성

GuidAttribute TypeLibTypeAttribute

구현

IDTSObject100

예제

다음 코드 예제에서는 프로그래밍 방식으로 데이터 흐름 태스크를 빌드할 때 가상 입력을 사용하여 구성 요소에서 사용하는 열을 선택하는 방법을 보여 줍니다.

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  

다음 코드 예제에서는 입력이 경로에 연결 될 때 가상 입력에서 모든 DT_STR 열을 선택 하는 사용자 지정 데이터 흐름 구성 요소를 보여 줍니다.

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  

설명

IDTSVirtualInput100 개체의 메서드를 GetVirtualInput 호출하여 검색됩니다IDTSInput100. 이 속성에는 VirtualInputColumnCollection 그래프의 업스트림 구성 요소에서 사용할 수 있는 열이 포함됩니다.

프로그래밍 방식으로 데이터 흐름 태스크를 빌드할 때 가상 열은 구성 요소에 대해 의 CManagedComponentWrapperClass메서드를 SetUsageType 호출하여 선택됩니다.

사용자 지정 데이터 흐름 구성 요소를 작성하는 개발자는 가상 입력을 사용하여 사용 가능한 업스트림 열을 검색하고 구성 요소에 따라 가상 컬렉션의 열을 기반으로 입력에 열을 추가합니다.

가상 입력은 업스트림 열을 반영하므로 가상 입력 또는 가상 입력 컬렉션의 열에 대한 수정은 자체에 IDTSOutput100 영향을 주지 않습니다.

속성

Description	IDTSVirtualInput100 개체에 대한 설명을 가져오거나 설정합니다.
ID	가상 입력 개체의 ID를 가져오거나 설정합니다.
IdentificationString	IDTSVirtualInput100을 고유하게 식별하는 문자열을 가져옵니다.
IsSorted	IDTSVirtualInput100의 가상 입력 열이 정렬되는지 여부를 나타내는 값을 가져옵니다.
Name	IDTSVirtualInput100의 이름을 가져오거나 설정합니다.
ObjectType	DTSObjectType의 IDTSVirtualInput100을 가져옵니다.
SourceLocale	IDTSVirtualInput100 원본의 LCID(로캘 ID)를 가져옵니다.
VirtualInputColumnCollection	IDTSVirtualInputColumnCollection100의 IDTSVirtualInput100을 가져옵니다.

메서드

SetUsageType(Int32, DTSUsageType)

가상 입력 열 개체를 매핑하고 해당 사용 유형을 설정합니다.