IDTSComponentEvents.FireProgress 方法

定义

命名空间:

Microsoft.SqlServer.Dts.Runtime

程序集:

Microsoft.SqlServer.ManagedDTS.dll

在可执行文件的进度可度量时引发事件。

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)

参数

progressDescription

String

描述引发的进度事件的字符串。

percentComplete

Int32

一个整数，用于指示任务的完成程度。

progressCountLow

Int32

一个整数，包含已完成的单位的低 32 位。

progressCountHigh

Int32

包含已完成单元的高 32 位的整数。

subComponent

String

一个包含有关事件源的详细信息的字符串。

fireAgain

Boolean

一个布尔值，指示这应该继续触发或停止触发。 true 值指示它应继续激发。

注解

由于触发事件可能很昂贵，因此运行时引擎提供了一种用于抑制你不感兴趣的事件的机制。 每个事件激发方法都有一个 FireAgain 参数。 如果此变量的值在 false方法返回后，调用方在当前执行期间不会再次触发此事件。

其中几个事件具有一个 subComponent 参数，该参数允许在事件源标识中实现更大的粒度。