다음을 통해 공유


IDTSComponentMetaData100.Instantiate 메서드

정의

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 만들어집니다. 구성 요소의 디자인 타임 인스턴스는 구성 요소의 메타데이터를 편집하고 구성하기 위해 만들어집니다. 구성 요소가 메타데이터에 대한 변경 내용을 모니터링하고 유효성을 검사할 수 있도록 구성 요소 메타데이터에 직접 액세스하는 대신 구성 요소를 편집하는 데 디자인 타임 인스턴스를 사용해야 합니다.

적용 대상