PipelineComponent.RegisterEvents Method

Article
12/03/2008

When you are developing a custom data flow component, you override this method to create custom events.

Namespace: Microsoft.SqlServer.Dts.Pipeline
Assembly: Microsoft.SqlServer.PipelineHost (in microsoft.sqlserver.pipelinehost.dll)

Syntax

'Declaration
Public Overridable Sub RegisterEvents

public virtual void RegisterEvents ()

public:
virtual void RegisterEvents ()

public void RegisterEvents ()

public function RegisterEvents ()

Remarks

This method is overridden by components that create custom events. Because the custom events declared by a component are not persisted in the package XML, this method is called as the component is loaded into the designer, and at the start of execution.

For more information, see Raising and Defining Events in a Data Flow Component.

Example

The following example shows a component that overrides this method and creates a custom event using the EventInfos collection.

public override void RegisterEvents()
{
string[] parameters = new string[1]{"Parameter1"};
ushort[] types = new ushort[1]{DtsConvert.VarTypeFromTypeCode(TypeCode.String)};
string[] descriptions = new string [1]{"The first parameter."};

EventInfos.Add("OnPreExecute", "Fires when the PreExecute method runs.", false, ref parameters, ref types, ref descriptions);

}

Public Overrides Sub RegisterEvents() 
 Dim parameters As String() = New String(1) {"Parameter1"} 
 Dim types As System.UInt16() = New System.UInt16(1) {DtsConvert.VarTypeFromTypeCode(TypeCode.String)} 
 Dim descriptions As String() = New String(1) {"The first parameter."} 
 EventInfos.Add("OnPreExecute", "Fires when the PreExecute method runs.", False, parameters, types, descriptions) 
End Sub

Thread Safety

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.

Platforms

Development Platforms

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

Target Platforms

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

Share via