IDTSDesigntimeComponent100 インターフェイス

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

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

構文

'宣言
<GuidAttribute("B13097E5-4465-4A9C-BB74-FFC8F8E30760")> _
Public Interface IDTSDesigntimeComponent100
'使用
Dim instance As IDTSDesigntimeComponent100

[GuidAttribute("B13097E5-4465-4A9C-BB74-FFC8F8E30760")]
public interface IDTSDesigntimeComponent100

[GuidAttribute(L"B13097E5-4465-4A9C-BB74-FFC8F8E30760")]
public interface class IDTSDesigntimeComponent100

[<GuidAttribute("B13097E5-4465-4A9C-BB74-FFC8F8E30760")>]
type IDTSDesigntimeComponent100 =  interface end

public interface IDTSDesigntimeComponent100

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

メソッド

	名前	説明
	AcquireConnections	接続マネージャーへの接続を確立します。
	DeleteExternalMetadataColumn	外部メタデータ列のコレクションから、指定したインデックスにある外部メタデータ列を削除します。
	DeleteInput	IDTSInput100 オブジェクトを IDTSInputCollection100 コレクションから削除します。
	DeleteOutput	IDTSOutput100 オブジェクトを IDTSOutputCollection100 コレクションから削除します。
	DeleteOutputColumn	IDTSOutputColumn100 オブジェクトを IDTSOutputColumnCollection100 コレクションから削除します。
	DescribeRedirectedErrorCode	指定したエラー コードの説明を返します。
	GetEnumerationCollection	コンポーネントの IDTSFriendlyEnumCollection100 を返します。
	InsertExternalMetadataColumnAt	外部メタデータ列のコレクションに、指定したインデックスにある新しい外部メタデータ列を挿入します。
	InsertInput	IDTSInputCollection100 に IDTSInput100 オブジェクトを追加します。
	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	コンポーネントの IDTSInputColumnCollection100 に IDTSInputColumn100 オブジェクトを作成し、列の UsageType プロパティを設定します。
	Validate	コンポーネントが正しく構成されていることを確認します。

先頭に戻る

説明

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

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

使用例

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

Package p = new Package();
MainPipe dataFlow = ((TaskHost)p.Executables.Add("SSIS.Pipeline.2")).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("SSIS.Pipeline.2"), 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 名前空間