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
一个布尔值表示该信号应继续或停止发射。 值为真则表示应继续发射。
注解
由于触发事件可能成本高昂,运行时引擎提供了一种机制来抑制你不感兴趣的事件。 每种事件触发方法都有参数 FireAgain 。 如果该变量的值为 false,方法返回后调用者在当前执行期间不会再次触发该事件。
其中几个事件有一个 subComponent 参数,使事件源识别更加细致。