IDTSComponentMetaData100.Instantiate Methode

Definition

Erstellt eine Instanz einer von der ComponentClassID-Eigenschaft angegebenen Komponente.

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

Die CManagedComponentWrapper-Klasse der Komponente.

Attribute

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die Entwurfszeitinstanz einer Komponente verwendet wird, um die benutzerdefinierte Eigenschaft einer Komponente festzulegen. In diesem Beispiel könnten die CustomPropertyCollection Metadaten der Komponente verwendet werden, um die Eigenschaft direkt festzulegen, die Fähigkeit der Komponente jedoch zu umgehen, um änderungen an der Eigenschaft zu überwachen und 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 Entwurfszeitinstanz der von der ComponentClassID Eigenschaft definierten Komponente erstellt. Die Entwurfszeitinstanz der Komponente wird erstellt, um die Metadaten einer Komponente zu bearbeiten und zu konfigurieren. Die Entwurfszeitinstanz sollte zum Bearbeiten einer Komponente verwendet werden, anstatt direkt auf die Komponentenmetadaten zuzugreifen, damit die Komponente Änderungen an den Metadaten überwachen und überprüfen kann.

Gilt für: