IDTSComponentEvents.FireProgress 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í.
Activa un evento cuando el ejecutable realiza un progreso que se puede medir.
public:
void FireProgress(System::String ^ progressDescription, int percentComplete, int progressCountLow, int progressCountHigh, System::String ^ subComponent, bool % fireAgain);public void FireProgress (string progressDescription, int percentComplete, int progressCountLow, int progressCountHigh, string subComponent, ref bool fireAgain);abstract member FireProgress : string * int * int * int * string * bool -> unitPublic Sub FireProgress (progressDescription As String, percentComplete As Integer, progressCountLow As Integer, progressCountHigh As Integer, subComponent As String, ByRef fireAgain As Boolean)Parámetros
- progressDescription
- String
Cadena que describe el evento de progreso que se genera.
- percentComplete
- Int32
Entero usado para indicar cuánto se ha completado la tarea.
- progressCountLow
- Int32
Entero que contiene los 32 bits bajos de las unidades completadas.
- progressCountHigh
- Int32
Entero que contiene los 32 bits altos de las unidades completadas.
- 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 de 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 eventos que no le interesen. 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 mayor granularidad en la identificación del origen de eventos.