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 。

属性

名称	说明
Description	获取或设置一个 IDTSVirtualInput100 对象的描述。
ID	获取或设置虚拟输入对象的ID。
IdentificationString	得到一个唯一标识 的字符串。IDTSVirtualInput100
IsSorted	获得一个值，表示虚拟 IDTSVirtualInput100 输入列是否已排序。
Name	获得或设置 一个 IDTSVirtualInput100的名称。
ObjectType	得到 DTSObjectType 一个 IDTSVirtualInput100的 。
SourceLocale	获取源 IDTSVirtualInput100的 locale ID（LCID）。
VirtualInputColumnCollection	得到 IDTSVirtualInputColumnCollection100 一个 IDTSVirtualInput100的 。

方法

名称	说明
SetUsageType(Int32, DTSUsageType)	映射虚拟输入列对象并设置其使用类型。