IDTSComponentEvents.FireProgress 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在可执行文件的进度可度量时引发事件。
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
参数,该参数允许在事件源标识中实现更大的粒度。