IDTSComponentMetaData100.Instantiate メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ComponentClassIDプロパティで指定されたコンポーネントのインスタンスを作成します。
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::CManagedComponentWrapper ^ Instantiate();
[System.Runtime.InteropServices.DispId(104)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapper Instantiate();
[<System.Runtime.InteropServices.DispId(104)>]
abstract member Instantiate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapper
Public Function Instantiate () As CManagedComponentWrapper
返品
コンポーネントの CManagedComponentWrapper クラスです。
- 属性
例
以下のコードサンプルは、コンポーネントのデザイン時インスタンスを使ってカスタムプロパティを設定する方法を示しています。 この例では、コンポーネントメタデータの CustomPropertyCollection を使ってプロパティを直接設定できますが、コンポーネントがプロパティの変更を監視・応答する能力をバイパスします。
IDTSComponentMetaData100 cmp = dataflowTask.ComponentMetaDataCollection.New();
cmp.ComponentClassID = "DTSAdapter.OleDbSource";
CManagedComponentWrapper dtSource = cmp.Instantiate();
dtSource.SetComponentProperty("SqlCommand","select * from Production.Products");
Dim cmp As IDTSComponentMetaData100 = dataflowTask.ComponentMetaDataCollection.New
cmp.ComponentClassID = "DTSAdapter.OleDbSource"
Dim dtSource As CManagedComponentWrapper = cmp.Instantiate
dtSource.SetComponentProperty("SqlCommand", "select * from Production.Products")
注釈
このメソッドが呼び出されると、 ComponentClassID プロパティで定義されたコンポーネントの設計時インスタンスが作成されます。 コンポーネントのデザイン時インスタンスは、コンポーネントのメタデータを編集・設定するために作成されます。 設計時インスタンスはコンポーネントのメタデータに直接アクセスするのではなく、編集に使用すべきであり、コンポーネントがメタデータの変更を監視・検証できるようにします。