Export (0) Print
Expand All

CManagedComponentWrapper Interface

Configures the properties and column collections of a component.

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

[CoClassAttribute(typeof(CManagedComponentWrapperClass))]
[GuidAttribute("0058874E-E037-4BA9-920C-349773B5351A")]
public interface CManagedComponentWrapper : IDTSDesigntimeComponent100

The CManagedComponentWrapper type exposes the following members.

  NameDescription
Public methodAcquireConnectionsEstablishes a connection to a connection manager. (Inherited from IDTSDesigntimeComponent100.)
Public methodDeleteExternalMetadataColumnDeletes the external metadata column at the specified index from the collection of external metadata columns. (Inherited from IDTSDesigntimeComponent100.)
Public methodDeleteInputDeletes an IDTSInput100 object from the IDTSInputCollection100 collection. (Inherited from IDTSDesigntimeComponent100.)
Public methodDeleteOutputDeletes an IDTSOutput100 object from the IDTSOutputCollection100 collection. (Inherited from IDTSDesigntimeComponent100.)
Public methodDeleteOutputColumnDeletes an IDTSOutputColumn100 object from the IDTSOutputColumnCollection100 collection. (Inherited from IDTSDesigntimeComponent100.)
Public methodDescribeRedirectedErrorCodeReturns the description of the specified error code. (Inherited from IDTSDesigntimeComponent100.)
Public methodGetEnumerationCollectionReturns the IDTSFriendlyEnumCollection100 of a component. (Inherited from IDTSDesigntimeComponent100.)
Public methodInsertExternalMetadataColumnAtInserts a new external metadata column into the collection of external metadata columns at the specified index. (Inherited from IDTSDesigntimeComponent100.)
Public methodInsertInputAdds an IDTSInput100 object to the IDTSInputCollection100. (Inherited from IDTSDesigntimeComponent100.)
Public methodInsertOutputAdds a new IDTSOutput100 object. (Inherited from IDTSDesigntimeComponent100.)
Public methodInsertOutputColumnAtCreates a new IDTSOutputColumn100 object and inserts it into the IDTSOutputColumnCollection100. (Inherited from IDTSDesigntimeComponent100.)
Public methodMapInputColumnEstablishes a relationship between an input column and a corresponding external metadata column. (Inherited from IDTSDesigntimeComponent100.)
Public methodMapOutputColumnEstablishes a relationship between an output column and a corresponding external metadata column. (Inherited from IDTSDesigntimeComponent100.)
Public methodOnDeletingInputColumnCalled when deleting an IDTSInputColumn100 object from the IDTSInputColumnCollection100. (Inherited from IDTSDesigntimeComponent100.)
Public methodOnInputPathAttachedCalled when an IDTSInput100 object is connected to another component through the IDTSPath100 interface. (Inherited from IDTSDesigntimeComponent100.)
Public methodOnInputPathDetachedCalled when an IDTSPath100 object that contains the specified IDTSInput100 object is deleted. (Inherited from IDTSDesigntimeComponent100.)
Public methodOnOutputPathAttachedCalled when an IDTSOutput100 object of the component is attached to a downstream component. (Inherited from IDTSDesigntimeComponent100.)
Public methodProvideComponentPropertiesInitializes the ComponentMetaData of the component when a component is first added to the data flow task. (Inherited from IDTSDesigntimeComponent100.)
Public methodReinitializeMetaDataFixes any errors identified during design-time validation that result in the component returning VS_NEEDSNEWMETADATA. (Inherited from IDTSDesigntimeComponent100.)
Public methodReleaseConnectionsFrees the connections established during AcquireConnections at either design time or run time. (Inherited from IDTSDesigntimeComponent100.)
Public methodSetComponentPropertyAssigns a value to an IDTSCustomProperty100 of a component. (Inherited from IDTSDesigntimeComponent100.)
Public methodSetExternalMetadataColumnDataTypePropertiesSets the data type properties of the specified external metadata column. (Inherited from IDTSDesigntimeComponent100.)
Public methodSetExternalMetadataColumnPropertySets an individual property of an external metadata column. (Inherited from IDTSDesigntimeComponent100.)
Public methodSetInputColumnPropertyAssigns a value to the IDTSCustomProperty100 of an IDTSInputColumn100 object. (Inherited from IDTSDesigntimeComponent100.)
Public methodSetInputPropertyAssigns a value to the IDTSCustomProperty100 of an IDTSInput100 object. (Inherited from IDTSDesigntimeComponent100.)
Public methodSetOutputColumnDataTypePropertiesSets the data type properties of an IDTSOutputColumn100 object. (Inherited from IDTSDesigntimeComponent100.)
Public methodSetOutputColumnPropertySets the value of an IDTSCustomProperty100 for an IDTSOutputColumn100 object. (Inherited from IDTSDesigntimeComponent100.)
Public methodSetOutputPropertySets the value of an IDTSCustomProperty100 for an IDTSOutput100 object. (Inherited from IDTSDesigntimeComponent100.)
Public methodSetUsageTypeCreates an IDTSInputColumn100 object in the IDTSInputColumnCollection100 of the component and sets the UsageType property of the column. (Inherited from IDTSDesigntimeComponent100.)
Public methodValidateVerifies that the component is correctly configured. (Inherited from IDTSDesigntimeComponent100.)
Top

The CManagedComponentWrapper represents the interface of IDTSDesigntimeComponent100 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 IDTSComponentMetaData100 interface.

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

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.
                IDTSComponentMetaData100 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();
            }
        }
    }
}
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft