• [アーティクル]

SetUsageType メソッド

コンポーネントの IDTSInputColumnCollection100 に IDTSInputColumn100 オブジェクトを作成し、列の UsageType プロパティを設定します。

名前空間:  Microsoft.SqlServer.Dts.Pipeline.Wrapper
アセンブリ:  Microsoft.SqlServer.DTSPipelineWrap (Microsoft.SqlServer.DTSPipelineWrap.dll)

構文

'宣言
Public Overridable Function SetUsageType ( _
    lInputID As Integer, _
    pIDTSVirtualInputObject As IDTSVirtualInput100, _
    lLineageID As Integer, _
    eUsageType As DTSUsageType _
) As IDTSInputColumn100
'使用
Dim instance As CManagedComponentWrapperClass
Dim lInputID As Integer
Dim pIDTSVirtualInputObject As IDTSVirtualInput100
Dim lLineageID As Integer
Dim eUsageType As DTSUsageType
Dim returnValue As IDTSInputColumn100

returnValue = instance.SetUsageType(lInputID, _
    pIDTSVirtualInputObject, lLineageID, _
    eUsageType)

public virtual IDTSInputColumn100 SetUsageType(
    int lInputID,
    IDTSVirtualInput100 pIDTSVirtualInputObject,
    int lLineageID,
    DTSUsageType eUsageType
)

public:
virtual IDTSInputColumn100^ SetUsageType(
    [InAttribute] int lInputID, 
    [InAttribute] IDTSVirtualInput100^ pIDTSVirtualInputObject, 
    [InAttribute] int lLineageID, 
    [InAttribute] DTSUsageType eUsageType
)

abstract SetUsageType : 
        lInputID:int * 
        pIDTSVirtualInputObject:IDTSVirtualInput100 * 
        lLineageID:int * 
        eUsageType:DTSUsageType -> IDTSInputColumn100 
override SetUsageType : 
        lInputID:int * 
        pIDTSVirtualInputObject:IDTSVirtualInput100 * 
        lLineageID:int * 
        eUsageType:DTSUsageType -> IDTSInputColumn100 

public function SetUsageType(
    lInputID : int, 
    pIDTSVirtualInputObject : IDTSVirtualInput100, 
    lLineageID : int, 
    eUsageType : DTSUsageType
) : IDTSInputColumn100

パラメーター

戻り値

型: Microsoft.SqlServer.Dts.Pipeline.Wrapper. . :: . .IDTSInputColumn100
使用法の種類が設定された IDTSInputColumn100、または列がコレクションから削除された場合は nullNothingnullptrunitNULL 参照 (Visual Basic では Nothing) です。

実装

IDTSDesigntimeComponent100. . :: . .SetUsageType(Int32, IDTSVirtualInput100, Int32, DTSUsageType)

説明

このメソッドは、データ フロー グラフの上流コンポーネントから、コンポーネントで使用される列を選択するために使用されます。コンポーネントの InputColumnCollection に対して IDTSInputColumn100 を追加または削除するには、このメソッドを呼び出します。また、コンポーネントが列への読み取り専用アクセス権を持っているかどうか、または実行中に列の値を上書きできるかどうかを指定します。

eusageType が UT_READONLY または UT_READWRITE である場合、コンポーネントは入力列コレクションに列を追加し、実行中にデータ フロー エンジンに列を提供します。UT_IGNORED が指定され、列が以前にコレクションに追加されていた場合、その列は削除されます。

使用例

次のコード例は、SetUsageType を使用して、コンポーネントで使用される列を上流コンポーネントから選択する方法を示しています。この例では、パッケージが既に作成または読み込まれていて、データ フロー タスクとコンポーネントが既にパッケージに追加されていることを前提としています。

IDTSComponentMetaData100 md = dataFlow.ComponentMetaDataCollection[1];
CManagedComponentWrapper wrp = md.Instantiate();
IDTSInput100 input = md.InputCollection[0];
IDTSVirtualInput100 vInput = input.GetVirtualInput();

foreach(IDTSVirtualInputColumn100 vCol in vInput.VirtualInputColumnCollection)
{
    wrp.SetUsageType(input.ID,vInput,vCol.LineageID,DTSUsageType.UT_READWRITE);
}