Artırılarak ve olayları bir veri tanımlama bileşen akış

Özel olaylar çağırarak oluşturulur Add yöntem, EventInfos koleksiyon.Bu koleksiyonu küme tarafından veri akışı görevi ve bileşen geliştirici ile için bir özellik olarak sunulan PipelineComponent temel sınıfaÖzel olaylar sırasında bileşen tarafından tanımlanmış ve veri akışı görevi tarafından tanımlanan özel olaylar bu sınıf içeren RegisterEvents yöntem.

Bir bileşenin özel olaylar içinde kalıcı olmaz paket xml.Bu nedenle, RegisterEvents yöntem çağrılır hem tasarım hem yürütme sırasında bileşen izin vermek için olayları tanımlamak için bunu raises.

The allowEventHandlers parameter of the Add method specifies whether the component allows DtsEventHandler objects to be created for the event.Dikkat DtsEventHandlers eşzamanlıdır.Bu nedenle bileşen yürütme kadar devam etmez bir DtsEventHandler özel olarak bağlanmış olay yürütme bitirdi.If the allowEventHandlers parameter is true, each parameter of the event is automatically made available to any DtsEventHandler objects through variables that are created and populated automatically by the SQL Server Integration Services runtime.

Bileşenleri yükseltmek özel olaylar çağırarak FireCustomEvent yöntem ve sağlama adı, metin ve parametreleri olay.If the allowEventHandlers parameter is true, any DtsEventHandlers that are created for the custom event are executed by the SSIS run-time engine.

Aşağıdaki kod örneği, özel bir olay sırasında tanımlayan bir bileşeni gösterir RegisterEvents , yöntem ve çalışma sırasında olay harekete geçiren saat çağırarak FireCustomEvent yöntemi.

public override void RegisterEvents()
{
    string [] parameterNames = new string[2]{"RowCount", "StartTime"};
    ushort [] parameterTypes = new ushort[2]{ DtsConvert.VarTypeFromTypeCode(TypeCode.Int32), DtsConvert.VarTypeFromTypeCode(TypeCode.DateTime)};
    string [] parameterDescriptions = new string[2]{"The number of rows to sort.", "The start time of the Sort operation."};
    EventInfos.Add("StartingSort","Fires when the component begins sorting the rows.",false,ref parameterNames, ref paramterTypes, ref parameterDescriptions);
}
public override void ProcessInput(int inputID, PipelineBuffer buffer)
{
    while (buffer.NextRow())
    {
       // Process buffer rows.
    }

    IDTSEventInfo100 eventInfo = EventInfos["StartingSort"];
    object []arguments = new object[2]{buffer.RowCount, DateTime.Now };
    ComponentMetaData.FireCustomEvent("StartingSort", "Beginning sort operation.", ref arguments, ComponentMetaData.Name, ref FireSortEventAgain);
}

Public  Overrides Sub RegisterEvents() 
  Dim parameterNames As String() = New String(2) {"RowCount", "StartTime"} 
  Dim parameterTypes As System.UInt16() = New System.UInt16(2) {DtsConvert.VarTypeFromTypeCode(TypeCode.Int32), DtsConvert.VarTypeFromTypeCode(TypeCode.DateTime)} 
  Dim parameterDescriptions As String() = New String(2) {"The number of rows to sort.", "The start time of the Sort operation."} 
  EventInfos.Add("StartingSort", "Fires when the component begins sorting the rows.", False, parameterNames, paramterTypes, parameterDescriptions) 
End Sub 

Public  Overrides Sub ProcessInput(ByVal inputID As Integer, ByVal buffer As PipelineBuffer) 
  While buffer.NextRow 
  End While 
  Dim eventInfo As IDTSEventInfo100 = EventInfos("StartingSort") 
  Dim arguments As Object() = New Object(2) {buffer.RowCount, DateTime.Now} 
  ComponentMetaData.FireCustomEvent("StartingSort", _
    "Beginning sort operation.", arguments, _
    ComponentMetaData.Name, FireSortEventAgain) 
End Sub