IDTSComponentEvents.FireProgress Methode

Definition

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

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 -> unit

Public 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.