IDTSComponentEvents.FireProgress Methode

Definition

Namespace:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

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.

Erzeugt ein Ereignis, wenn messbarer Fortschritt von der ausführbaren Datei erzielt wird.

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 Zeichenkette, die das Fortschrittsereignis beschreibt, das ausgelöst wird.

percentComplete: Int32

Eine ganze Zahl zeigt an, wie viel von der Aufgabe abgeschlossen ist.

progressCountLow: Int32

Eine ganze Zahl, die die niedrigen 32 Bit der abgeschlossenen Einheiten enthält.

progressCountHigh: Int32

Eine Ganzzahl, die die hohen 32 Bits der abgeschlossenen Einheiten enthält.

subComponent: String

Eine Zeichenkette, die mehr Details zur Ereignisquelle enthält.

fireAgain: Boolean

Ein Boolean, der anzeigt, dass dies weiter feuern oder aufhören sollte. Ein Wert von "wahr" zeigt an, dass es weiter feuern sollte.

Hinweise

Da das Auslösen eines Ereignisses teuer sein kann, bietet die Laufzeit-Engine einen Mechanismus, um Ereignisse zu unterdrücken, die dich nicht interessieren. Jede Ereignis-Zündmethode hat einen Parameter FireAgain . Wenn der Wert dieser Variablen ist false, wird der Aufrufer dieses Ereignis nach der Rückkehr der Methode während der aktuellen Ausführung nicht erneut auslösen.

Mehrere der Ereignisse besitzen einen Parameter subComponent , der eine noch größere Granularität bei der Identifikation der Ereignisquelle ermöglicht.

Gilt für: