IDTSDesigntimeComponent90 Interface

Article
12/03/2008

Defines the design-time methods of a data flow component written in C++ and COM.

Namespace: Microsoft.SqlServer.Dts.Pipeline.Wrapper
Assembly: Microsoft.SqlServer.DTSPipelineWrap (in microsoft.sqlserver.dtspipelinewrap.dll)

Syntax

'Declaration
<TypeLibTypeAttribute(4160)> _
<GuidAttribute("76F19268-BCE0-4A23-95D1-F85AC738941D")> _
Public Interface IDTSDesigntimeComponent90

[TypeLibTypeAttribute(4160)] 
[GuidAttribute("76F19268-BCE0-4A23-95D1-F85AC738941D")] 
public interface IDTSDesigntimeComponent90

[TypeLibTypeAttribute(4160)] 
[GuidAttribute(L"76F19268-BCE0-4A23-95D1-F85AC738941D")] 
public interface class IDTSDesigntimeComponent90

/** @attribute TypeLibTypeAttribute(4160) */ 
/** @attribute GuidAttribute("76F19268-BCE0-4A23-95D1-F85AC738941D") */ 
public interface IDTSDesigntimeComponent90

TypeLibTypeAttribute(4160) 
GuidAttribute("76F19268-BCE0-4A23-95D1-F85AC738941D") 
public interface IDTSDesigntimeComponent90

Remarks

This interface is one of two interfaces implemented by data flow components; IDTSRuntimeComponent90 is the other. This interface defines the design-time interface for a component and contains methods that are called when the component properties and collections of the ComponentMetaData are modified. Managed component developers do not explicitly implement this interface, and instead use the PipelineComponent base class, which implements the methods of both these interfaces.

When programmatically adding or modifying existing components in a data flow task, the design-time instance of a component should be used instead of accessing the component metadata directly. Modifying the ComponentMetaData directly bypasses the ability of the component to validate and reject changes to its metadata, and should be avoided. Managed code developers access the design-time instance of a component, and use the methods of the IDTSDesigntimeComponent90 interface, through the CManagedComponentWrapper.

Example

The following code example demonstrates how to access the design-time instance of a component.

Package p = new Package();
MainPipe dataFlow = ((TaskHost)p.Executables.Add("DTS.Pipeline")).InnerObject as MainPipe;

IDTSComponentMetaData90 md = dataFlow.ComponentMetaDataCollection.New();
md.ComponentClassID = "DTSAdapter.OleDbSource";
CManagedComponentWrapper wrp = md.Instantiate();
wrp.ProvideComponentProperties();

Dim p As Package = New Package 
Dim dataFlow As MainPipe = CType(CType(p.Executables.Add("DTS.Pipeline"), TaskHost).InnerObject, MainPipe) 
Dim md As IDTSComponentMetaData90 = dataFlow.ComponentMetaDataCollection.New 
md.ComponentClassID = "DTSAdapter.OleDbSource" 
Dim wrp As CManagedComponentWrapper = md.Instantiate 
wrp.ProvideComponentProperties

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms