CManagedComponentWrapper Interface

Article
12/03/2008

Configures the properties and column collections of a component.

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

Syntax

'Declaration
<CoClassAttribute(GetType(CManagedComponentWrapperClass))> _
<GuidAttribute("76F19268-BCE0-4A23-95D1-F85AC738941D")> _
Public Interface CManagedComponentWrapper
    Inherits IDTSDesigntimeComponent90

[CoClassAttribute(typeof(CManagedComponentWrapperClass))] 
[GuidAttribute("76F19268-BCE0-4A23-95D1-F85AC738941D")] 
public interface CManagedComponentWrapper : IDTSDesigntimeComponent90

[CoClassAttribute(typeof(CManagedComponentWrapperClass))] 
[GuidAttribute(L"76F19268-BCE0-4A23-95D1-F85AC738941D")] 
public interface class CManagedComponentWrapper : IDTSDesigntimeComponent90

/** @attribute CoClassAttribute(Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass) */ 
/** @attribute GuidAttribute("76F19268-BCE0-4A23-95D1-F85AC738941D") */ 
public interface CManagedComponentWrapper extends IDTSDesigntimeComponent90

CoClassAttribute(Microsoft.SqlServer.Dts.Pipeline.Wrapper.CManagedComponentWrapperClass) 
GuidAttribute("76F19268-BCE0-4A23-95D1-F85AC738941D") 
public interface CManagedComponentWrapper extends IDTSDesigntimeComponent90

Remarks

The CManagedComponentWrapper represents the interface of IDTSDesigntimeComponent90 that is used in design time modification of a data flow component. CManagedComponentWrapper is used to configure the properties and column collections of a data flow component during design time. While the metadata of a component can be modified directly, this should be avoided because doing so bypasses the component's ability to validate modifications to its metadata. An instance of CManagedComponentWrapper is created by calling the Instantiate method of a component's IDTSComponentMetaData90 interface.

The methods and properties defined by the interface are visible on both the CManagedComponentWrapperClass and the IDTSDesigntimeComponent90 types.

Example

The following code example demonstrates how to programmatically add a component to a data flow task and create an instance of the design-time interface.

using System;
using Microsoft.SqlServer.Dts.Runtime;
using Microsoft.SqlServer.Dts.Pipeline.Wrapper;

namespace Microsoft.Samples.SqlServer.Dts
{
    class CreateComponent
    {
         [STAThread]
        static void Main(string[] args)
        {
            // Create the package.
            Package p = new Package();

            // Add the data flow task to the package.
            MainPipe dataFlowTask = ((TaskHost)p.Executables.Add("DTS.Pipeline.1")).InnerObject as MainPipe;

            if (dataFlowTask != null)
            {
                // Add a component to the data flow task.
                IDTSComponentMetaData90 metaData = dataFlowTask.ComponentMetaDataCollection.New();

                // Set the class id of the component.
                metaData.ComponentClassID = "";

                // Create an instance of the component.
                CManagedComponentWrapper wrapper = metaData.Instantiate();

                // Initialize the component by calling ProvideComponentProperties.
                wrapper.ProvideComponentProperties();
            }
        }
    }
}

Platforms

Development Platforms

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

Target Platforms