DefaultEvents.OnProgress 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.
Diese Methode nennt man immer dann, wenn eine Aufgabe messbaren Fortschritt macht.
public:
virtual void OnProgress(Microsoft::SqlServer::Dts::Runtime::TaskHost ^ taskHost, System::String ^ progressDescription, int percentComplete, int progressCountLow, int progressCountHigh, System::String ^ subComponent, bool % fireAgain);
public virtual void OnProgress(Microsoft.SqlServer.Dts.Runtime.TaskHost taskHost, string progressDescription, int percentComplete, int progressCountLow, int progressCountHigh, string subComponent, ref bool fireAgain);
abstract member OnProgress : Microsoft.SqlServer.Dts.Runtime.TaskHost * string * int * int * int * string * bool -> unit
override this.OnProgress : Microsoft.SqlServer.Dts.Runtime.TaskHost * string * int * int * int * string * bool -> unit
Public Overridable Sub OnProgress (taskHost As TaskHost, progressDescription As String, percentComplete As Integer, progressCountLow As Integer, progressCountHigh As Integer, subComponent As String, ByRef fireAgain As Boolean)
Parameter
- taskHost
- TaskHost
Ein NULL-Wert.
- progressDescription
- String
Eine Zeichenkette, die den Fortschritt des aufgestellten Ereignisses beschreibt.
- percentComplete
- Int32
Eine ganze Zahl, die angibt, wie viel der Aufgabe abgeschlossen ist.
- progressCountLow
- Int32
Eine ganze Zahl, die die niedrigen 32 Bits der abgeschlossenen Einheiten enthält.
- progressCountHigh
- Int32
Eine ganze Zahl, die die höchsten 32 Bits der abgeschlossenen Einheiten enthält.
- subComponent
- String
Eine Zeichenkette, die mehr Details zur Ereignisquelle enthält.
- fireAgain
- Boolean
Ein Boolean, das angibt, ob dieser weiter schießen oder aufhören soll. Ein Wert von "wahr" zeigt an, dass es weiter feuern sollte.
Implementiert
Hinweise
Jede Aufgabe hat ihre eigenen Anforderungen, aber als allgemeine Regel meldet eine Aufgabe den Fortschritt in Schritten von 1 Prozent. OnProgress wird von der Aufgabe in vorgegebenen Intervallen aufgerufen, um die hörenden Clients über den Fortschritt einer bestimmten Aufgabe zu informieren.