IDtsComponentUI.Initialize(IDTSComponentMetaData100, IServiceProvider) Method

Definition

Called to initialize the user interface of the component.

public:
 void Initialize(Microsoft::SqlServer::Dts::Pipeline::Wrapper::IDTSComponentMetaData100 ^ dtsComponentMetadata, IServiceProvider ^ serviceProvider);
public void Initialize (Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSComponentMetaData100 dtsComponentMetadata, IServiceProvider serviceProvider);
abstract member Initialize : Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSComponentMetaData100 * IServiceProvider -> unit
Public Sub Initialize (dtsComponentMetadata As IDTSComponentMetaData100, serviceProvider As IServiceProvider)

Parameters

dtsComponentMetadata
IDTSComponentMetaData100

The IDTSComponentMetaData100 of the component.

serviceProvider
IServiceProvider

The http://go.microsoft.com/fwlink/?LinkId=33994 IServiceProvider interface provided by the SSIS designer.

Remarks

This method is called when a component is initially added to the SSIS Designer surface, and prior to the New method. It is also called when a component is edited, but prior to the Edit method.

Cache the object reference received in the dtsComponentMetadata parameter and use it in the Edit method to make changes to your component as the user interacts with your user interface. Typically, you must also pass this object reference to any supporting classes that you may create, such as a form class, to implement editing functionality for a component.

The serviceProvider parameter provides access to the services of the SSIS Designer. The following table shows the available services in the SSIS Designer.

Service Description
IDtsClipboardService Determines whether the component was generated as part of a copy/paste or cut/paste operation.
IDtsConnectionService Accesses existing and creates new connections in the package.
IDtsDesignerUtilitiesService Provides methods that let Integration Services developers invoke the Expression Builder dialog box programmatically.
IDtsPipelineEnvironmentService Gives data flow components access to the parent Data Flow task and its TaskHost container.
IDtsVariableService Accesses existing or creates new variables in the package.
IErrorCollectionService Captures events from data flow components when you have to capture all the errors and warnings raised by the component instead of receiving only the last error or warning.

These services provide component developers the ability to access and create objects in the package in which the component is loaded.

Applies to