IDTSComponentMetaData90.Instantiate Method

Artículo
12/15/2008

Creates an instance of a component specified by the ComponentClassID property.

Espacio de nombres: Microsoft.SqlServer.Dts.Pipeline.Wrapper
Ensamblado: Microsoft.SqlServer.DTSPipelineWrap (in microsoft.sqlserver.dtspipelinewrap.dll)

Sintaxis

'Declaración
<DispIdAttribute(104)> _
Function Instantiate As CManagedComponentWrapper

[DispIdAttribute(104)] 
CManagedComponentWrapper Instantiate ()

[DispIdAttribute(104)] 
CManagedComponentWrapper^ Instantiate ()

/** @attribute DispIdAttribute(104) */ 
CManagedComponentWrapper Instantiate ()

DispIdAttribute(104) 
function Instantiate () : CManagedComponentWrapper

Valor devuelto

The CManagedComponentWrapper class of the component.

Notas

When this method is called, the design-time instance of the component defined by the ComponentClassID property is created. The design-time instance of the component is created to edit and configure the metadata of a component. The design-time instance should be used for editing a component, instead of directly accessing the component metadata, to allow the component to monitor and validate changes to the metadata.

Ejemplo

The following code sample shows how the design-time instance of a component is used to set the custom property of a component. In this example, the CustomPropertyCollection of the component metadata could be used to directly set the property, but would bypass the ability of the component to monitor and respond to changes to the property.

IDTSComponentMetaData90 cmp = dataflowTask.ComponentMetaDataCollection.New();
cmp.ComponentClassID = "DTSAdapter.OleDbSource";
CManagedComponentWrapper dtSource = cmp.Instantiate();
dtSource.SetComponentProperty("SqlCommand","select * from Production.Products");

Dim cmp As IDTSComponentMetaData90 = dataflowTask.ComponentMetaDataCollection.New 
cmp.ComponentClassID = "DTSAdapter.OleDbSource" 
Dim dtSource As CManagedComponentWrapper = cmp.Instantiate 
dtSource.SetComponentProperty("SqlCommand", "select * from Production.Products")

Seguridad para subprocesos

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Plataformas

Plataformas de desarrollo

Para obtener una lista de las plataformas compatibles, vea Requisitos de hardware y software para instalar SQL Server 2005.

Plataformas de destino