IDTSComponentEvents.FireProgress Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löst ein Ereignis aus, wenn das ausführbare Element messbaren Fortschritt erzielt.
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)Parameter
- progressDescription
- String
Eine Zeichenfolge, die das Statusereignis beschreibt, das ausgelöst wird.
- percentComplete
- Int32
Eine ganze Zahl, die verwendet wird, um anzugeben, wie viel der Vorgang abgeschlossen ist.
- progressCountLow
- Int32
Eine Ganze Zahl, die die niedrigen 32-Bits der abgeschlossenen Einheiten enthält.
- progressCountHigh
- Int32
Eine Ganze Zahl, die die hohen 32-Bit-Werte der abgeschlossenen Einheiten enthält.
- subComponent
- String
Ein String-Wert, der weitere Details zur Ereignisquelle enthält.
- fireAgain
- Boolean
Ein boolescher Wert, der angibt, dass dies weiterhin ausgelöst oder beendet werden soll. Ein Wert von true gibt an, dass es weiterhin ausgelöst werden soll.
Hinweise
Da das Auslösen eines Ereignisses möglicherweise teuer ist, bietet das Laufzeitmodul einen Mechanismus zum Unterdrücken von Ereignissen, an denen Sie nicht interessiert sind. Jede Ereignis ausgelöste Methode weist einen FireAgain Parameter auf. Wenn der Wert dieser Variablen lautet false, wird dieses Ereignis nach dem Zurückgeben der Methode nicht erneut ausgelöst, bis die aktuelle Ausführung dauert.
Mehrere Ereignisse verfügen über einen subComponent Parameter, der eine noch größere Granularität in der Ereignisquellenidentifikation ermöglicht.