IDTSDesigntimeComponent100 インターフェイス

C++ と COM で作成されたデータ フロー コンポーネントのデザイン時メソッドを定義します。

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

構文

'宣言
<GuidAttribute("FF5DD3F1-99C1-4FFB-B097-1B1B2B9E9B2D")> _
Public Interface IDTSDesigntimeComponent100
'使用
Dim instance As IDTSDesigntimeComponent100
[GuidAttribute("FF5DD3F1-99C1-4FFB-B097-1B1B2B9E9B2D")]
public interface IDTSDesigntimeComponent100
[GuidAttribute(L"FF5DD3F1-99C1-4FFB-B097-1B1B2B9E9B2D")]
public interface class IDTSDesigntimeComponent100
[<GuidAttribute("FF5DD3F1-99C1-4FFB-B097-1B1B2B9E9B2D")>]
type IDTSDesigntimeComponent100 =  interface end
public interface IDTSDesigntimeComponent100

IDTSDesigntimeComponent100 型は、以下のメンバーを公開しています。

メソッド

  名前 説明
パブリック メソッド AcquireConnections 接続マネージャーへの接続を確立します。
パブリック メソッド DeleteExternalMetadataColumn 外部メタデータ列のコレクションから、指定したインデックスにある外部メタデータ列を削除します。
パブリック メソッド DeleteInput IDTSInput100 オブジェクトを IDTSInputCollection100 コレクションから削除します。
パブリック メソッド DeleteOutput IDTSOutput100 オブジェクトを IDTSOutputCollection100 コレクションから削除します。
パブリック メソッド DeleteOutputColumn IDTSOutputColumn100 オブジェクトを IDTSOutputColumnCollection100 コレクションから削除します。
パブリック メソッド DescribeRedirectedErrorCode 指定したエラー コードの説明を返します。
パブリック メソッド GetEnumerationCollection コンポーネントの IDTSFriendlyEnumCollection100 を返します。
パブリック メソッド InsertExternalMetadataColumnAt 外部メタデータ列のコレクションに、指定したインデックスにある新しい外部メタデータ列を挿入します。
パブリック メソッド InsertInput IDTSInputCollection100IDTSInput100 オブジェクトを追加します。
パブリック メソッド InsertOutput 新しい IDTSOutput100 オブジェクトを追加します。
パブリック メソッド InsertOutputColumnAt 新しい IDTSOutputColumn100 オブジェクトを作成して、IDTSOutputColumnCollection100 に挿入します。
パブリック メソッド MapInputColumn 入力列とそれに対応する外部メタデータ列との間にリレーションシップを確立します。
パブリック メソッド MapOutputColumn 出力列とそれに対応する外部メタデータ列との間にリレーションシップを確立します。
パブリック メソッド OnDeletingInputColumn IDTSInputColumn100 オブジェクトを IDTSInputColumnCollection100 から削除する場合に呼び出されます。
パブリック メソッド OnInputPathAttached IDTSPath100 インターフェイスを介して IDTSInput100 オブジェクトが別のコンポーネントに接続される場合に呼び出されます。
パブリック メソッド OnInputPathDetached 指定した IDTSInput100 オブジェクトを含む IDTSPath100 オブジェクトが削除される場合に呼び出されます。
パブリック メソッド OnOutputPathAttached コンポーネントの IDTSOutput100 オブジェクトが下流コンポーネントにアタッチされるときに呼び出されます。
パブリック メソッド ProvideComponentProperties コンポーネントが最初にデータ フロー タスクに追加されるとき、コンポーネントの ComponentMetaData を初期化します。
パブリック メソッド ReinitializeMetaData コンポーネントが VS_NEEDSNEWMETADATA を返す結果となる、デザイン時検証で識別されるエラーを修正します。
パブリック メソッド ReleaseConnections デザイン時または実行時に AcquireConnections で確立された接続を解放します。
パブリック メソッド SetComponentProperty コンポーネントの IDTSCustomProperty100 に値を割り当てます。
パブリック メソッド SetExternalMetadataColumnDataTypeProperties 指定した外部メタデータ列のデータ型プロパティを設定します。
パブリック メソッド SetExternalMetadataColumnProperty 外部メタデータ列の個別のプロパティを設定します。
パブリック メソッド SetInputColumnProperty IDTSInputColumn100 オブジェクトの IDTSCustomProperty100 に値を割り当てます。
パブリック メソッド SetInputProperty IDTSInput100 オブジェクトの IDTSCustomProperty100 に値を割り当てます。
パブリック メソッド SetOutputColumnDataTypeProperties IDTSOutputColumn100 オブジェクトのデータ型プロパティを設定します。
パブリック メソッド SetOutputColumnProperty IDTSOutputColumn100 オブジェクトの IDTSCustomProperty100 の値を設定します。
パブリック メソッド SetOutputProperty IDTSOutput100 オブジェクトの IDTSCustomProperty100 の値を設定します。
パブリック メソッド SetUsageType コンポーネントの IDTSInputColumnCollection100IDTSInputColumn100 オブジェクトを作成し、列の UsageType プロパティを設定します。
パブリック メソッド Validate コンポーネントが正しく構成されていることを確認します。

先頭に戻る

説明

このインターフェイスは、データ フロー コンポーネントによって実装される 2 つのインターフェイスのうちの 1 つで、もう 1 つは IDTSRuntimeComponent100 です。 このインターフェイスは、コンポーネントのデザイン時インターフェイスを定義し、コンポーネントのプロパティおよび ComponentMetaData のコレクションの変更時に呼び出されるメソッドを含みます。 マネージ コンポーネントを開発する場合は、このインターフェイスを明示的には実装せず、代わりに、両方のインターフェイスのメソッドを実装する PipelineComponent 基本クラスを使用します。

プログラムでデータ フロー タスクの既存のコンポーネントを追加または変更する場合、コンポーネント メタデータに直接アクセスするのではなく、コンポーネントのデザイン時インスタンスを使用する必要があります。 ComponentMetaData を直接変更すると、コンポーネントがメタデータの変更を検証および拒否する機能がバイパスされてしまうため、この方法は避けてください。 マネージ コードの開発者はコンポーネントのデザイン時インスタンスにアクセスし、CManagedComponentWrapper を通じて IDTSDesigntimeComponent100 インターフェイスのメソッドを使用します。

使用例

次のコード例では、コンポーネントのデザイン時インスタンスにアクセスしています。

Package p = new Package();
MainPipe dataFlow = ((TaskHost)p.Executables.Add("DTS.Pipeline")).InnerObject as MainPipe;

IDTSComponentMetaData100 md = dataFlow.ComponentMetaDataCollection.New();
md.ComponentClassID = "DTSAdapter.OleDbSource";
CManagedComponentWrapper wrp = md.Instantiate();
wrp.ProvideComponentProperties();
Dim p As Package = New Package 
Dim dataFlow As MainPipe = CType(CType(p.Executables.Add("DTS.Pipeline"), TaskHost).InnerObject, MainPipe) 
Dim md As IDTSComponentMetaData100 = dataFlow.ComponentMetaDataCollection.New 
md.ComponentClassID = "DTSAdapter.OleDbSource" 
Dim wrp As CManagedComponentWrapper = md.Instantiate 
wrp.ProvideComponentProperties

関連項目

参照

Microsoft.SqlServer.Dts.Pipeline.Wrapper 名前空間