IDTSComponentMetaData100.Instantiate Método

Definição

Namespace:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

Assembly:

Microsoft.SqlServer.DTSPipelineWrap.dll

Cria uma instância de um componente especificado pela propriedade 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

Retornos

CManagedComponentWrapper

A classe CManagedComponentWrapper do componente.

Atributos

DispIdAttribute

Exemplos

O exemplo de código a seguir mostra como a instância de tempo de design de um componente é usada para definir a propriedade personalizada de um componente. Neste exemplo, os CustomPropertyCollection metadados do componente poderiam ser usados para definir diretamente a propriedade, mas ignorariam a capacidade do componente de monitorar e responder a alterações na propriedade.

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

Comentários

Quando esse método é chamado, a instância de tempo de design do componente definido pela ComponentClassID propriedade é criada. A instância de tempo de design do componente é criada para editar e configurar os metadados de um componente. A instância de tempo de design deve ser usada para editar um componente, em vez de acessar diretamente os metadados do componente, para permitir que o componente monitore e valide as alterações nos metadados.