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 그래프 내 상류 구성 요소에서 이용 가능한 열을 포함합니다.

데이터 흐름 작업을 프로그래밍적으로 구축할 때, 가상 열은 의 메서드SetUsageType를 호출 CManagedComponentWrapperClass 하여 구성 요소에 대해 선택합니다.

사용자 지정 데이터 흐름 컴포넌트를 작성하는 개발자들은 가상 입력을 사용하여 사용 가능한 상류 컬럼을 발견하고, 컴포넌트에 따라 가상 컬렉션 내 컬럼을 기반으로 컬럼을 입력에 추가합니다.

가상 입력은 상류 컬럼의 반영이기 때문에, 가상 입력이나 가상 입력 컬렉션의 컬에 대한 변경은 자체 IDTSOutput100 에 영향을 미치지 않습니다.

속성

Name	Description
Description	객체의 IDTSVirtualInput100 설명을 얻거나 설정합니다.
ID	가상 입력 객체의 ID를 받거나 설정합니다.
IdentificationString	. 를 고유하게 식별하는 IDTSVirtualInput100문자열을 얻는다.
IsSorted	가상 입력 열 IDTSVirtualInput100 이 정렬되었는지 여부를 나타내는 값을 받습니다.
Name	. 의 이름을 IDTSVirtualInput100얻거나 설정합니다.
ObjectType	DTSObjectType IDTSVirtualInput100.
SourceLocale	이 데이터는 소스 IDTSVirtualInput100의 로컬 ID(LCID)를 얻습니다.
VirtualInputColumnCollection	IDTSVirtualInputColumnCollection100 IDTSVirtualInput100.

메서드

Name	Description
SetUsageType(Int32, DTSUsageType)	가상 입력 컬럼 객체를 매핑하고 사용 유형을 설정합니다.