Metodo IDTSComponentEvents.FireCustomEvent

  • Articolo

Occurs when tasks raise custom task-defined events.

Spazio dei nomi  Microsoft.SqlServer.Dts.Runtime
Assembly:  Microsoft.SqlServer.ManagedDTS (in Microsoft.SqlServer.ManagedDTS.dll)

Sintassi

'Dichiarazione
Sub FireCustomEvent ( _
    eventName As String, _
    eventText As String, _
    ByRef arguments As Object(), _
    subComponent As String, _
    ByRef fireAgain As Boolean _
)
'Utilizzo
Dim instance As IDTSComponentEvents 
Dim eventName As String 
Dim eventText As String 
Dim arguments As Object()
Dim subComponent As String 
Dim fireAgain As Boolean

instance.FireCustomEvent(eventName, eventText, _
    arguments, subComponent, fireAgain)

void FireCustomEvent(
    string eventName,
    string eventText,
    ref Object[] arguments,
    string subComponent,
    ref bool fireAgain
)

void FireCustomEvent(
    String^ eventName, 
    String^ eventText, 
    array<Object^>^% arguments, 
    String^ subComponent, 
    bool% fireAgain
)

abstract FireCustomEvent : 
        eventName:string * 
        eventText:string * 
        arguments:Object[] byref * 
        subComponent:string * 
        fireAgain:bool byref -> unit

function FireCustomEvent(
    eventName : String, 
    eventText : String, 
    arguments : Object[], 
    subComponent : String, 
    fireAgain : boolean
)

Parametri

  • arguments
    Tipo: array<System.Object[]%
    An array of arguments to pass to the event.
  • subComponent
    Tipo: System.String
    A String that contains more detail about the event source.
  • fireAgain
    Tipo: System.Boolean%
    A Boolean that indicates this should continue firing or stop firing. A value of true indicates that it should continue firing.

Osservazioni

Because firing of an event may be expensive, the run-time engine provides a mechanism for suppressing events that you are not interested in. Every event firing method has a FireAgain parameter. If the value of this variable is false, then after the method returns, the caller will not fire this event again for the duration of the current execution.

Several of the events have a subComponent parameter that allows for even greater granularity in event source identification.

Vedere anche

Riferimento

IDTSComponentEvents Interfaccia

Spazio dei nomi Microsoft.SqlServer.Dts.Runtime