IDTSComponentEvents.FireCustomEvent Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce cuando las tareas activan eventos personalizados definidos por la tarea.
public:
void FireCustomEvent(System::String ^ eventName, System::String ^ eventText, cli::array <System::Object ^> ^ % arguments, System::String ^ subComponent, bool % fireAgain);public void FireCustomEvent (string eventName, string eventText, ref object[] arguments, string subComponent, ref bool fireAgain);abstract member FireCustomEvent : string * string * Object[] * string * bool -> unitPublic Sub FireCustomEvent (eventName As String, eventText As String, ByRef arguments As Object(), subComponent As String, ByRef fireAgain As Boolean)Parámetros
- eventName
- String
Nombre del evento que se va a activar.
- eventText
- String
El texto que describe el evento.
- arguments
- Object[]
Una matriz de argumentos para pasar al evento.
- subComponent
- String
Un valor de tipo String que contiene más información sobre el origen del evento.
- fireAgain
- Boolean
Un valor booleano que indica que debe continuar activando o dejar de activarse. Un valor true indica que debe continuar activando.
Comentarios
Dado que la activación de un evento puede ser costosa, el motor en tiempo de ejecución proporciona un mecanismo para suprimir los eventos que no le interesan. Cada método de activación de eventos tiene un FireAgain parámetro . Si el valor de esta variable es false, después de que el método devuelva, el autor de la llamada no volverá a activar este evento durante la ejecución actual.
Varios de los eventos tienen un subComponent parámetro que permite una granularidad aún mayor en la identificación del origen de eventos.