IDTSComponentMetaData100.Instantiate Methode

Definition

Namespace:: Microsoft.SqlServer.Dts.Pipeline.Wrapper

Assembly:: Microsoft.SqlServer.DTSPipelineWrap.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erzeugt eine Instanz einer Komponente, die durch die Eigenschaft ComponentClassID bestimmt ist.

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

Gibt zurück

CManagedComponentWrapper

Die Klasse CManagedComponentWrapper der Komponente.

Attribute: DispIdAttribute

Beispiele

Das folgende Codebeispiel zeigt, wie die Design-Time-Instanz einer Komponente verwendet wird, um die benutzerdefinierte Eigenschaft einer Komponente festzulegen. In diesem Beispiel könnte die CustomPropertyCollection Metadaten der Komponente verwendet werden, um die Eigenschaft direkt festzulegen, würde jedoch die Möglichkeit der Komponente umgehen, Änderungen der Eigenschaft zu überwachen und darauf zu reagieren.

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")

Hinweise

Wenn diese Methode aufgerufen wird, wird die Design-Time-Instanz der durch die Eigenschaft ComponentClassID definierten Komponente erstellt. Die Design-Time-Instanz der Komponente wird erstellt, um die Metadaten einer Komponente zu bearbeiten und zu konfigurieren. Die Design-Time-Instanz sollte zur Bearbeitung einer Komponente verwendet werden, anstatt direkt auf die Metadaten zuzugreifen, damit die Komponente Änderungen an den Metadaten überwachen und validieren kann.

Gilt für: