IDTSComponentEvents.FireProgress(String, Int32, Int32, Int32, String, Boolean) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Genera un evento dopo un avanzamento misurabile del file eseguibile.
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 -> unit
Public Sub FireProgress (progressDescription As String, percentComplete As Integer, progressCountLow As Integer, progressCountHigh As Integer, subComponent As String, ByRef fireAgain As Boolean)
Parametri
- progressDescription
- String
Stringa che descrive l'evento di stato generato.
- percentComplete
- Int32
Intero utilizzato per indicare la quantità di attività completata.
- progressCountLow
- Int32
Intero contenente i 32 bit bassi delle unità completate.
- progressCountHigh
- Int32
Intero contenente i 32 bit alti delle unità completate.
- subComponent
- String
Valore String contenente maggiori dettagli sull'origine dell'evento.
- fireAgain
- Boolean
Un valore booleano che indica che questa operazione deve continuare o arrestare l'attivazione. Il valore true indica che la generazione deve continuare.
Commenti
Poiché l'attivazione di un evento può essere costosa, il motore di run-time fornisce un meccanismo per l'eliminazione degli eventi a cui non si è interessati. Ogni metodo di generazione di eventi ha un FireAgain parametro. Se il valore di questa variabile è false , dopo la restituzione del metodo, il chiamante non attiverà nuovamente questo evento per la durata dell'esecuzione corrente.
Molti eventi hanno un subComponent parametro che consente una granularità ancora maggiore nell'identificazione dell'origine evento.