BackGroundWork控件-----bgw
1. bgw.RunWorkerAsync(x) x----object
2. bgw.DoWork事件被触发
3. 调用DoWork事件处理方法DoWorkHandle(object sender, DoWorkEventArgs e),其中e.Argument为x
4. DoWorkHandle方法运行于异步线程t
5. 在DoWorkHandle方法中我们需要:a.检测bgw.CancellationPending属性,如果该属性为true,表示需要取消异步操作(通常是由bgw.CancelAsync方法引起的,及如果在主线程调用了bgw.CancelAsync方法,bgw.Cancel就为true); b.进行异步操作,并且调用bgw.ReportProcess(p)方法来报告异步操作的进展情况,p为一个整数,表示进展的大致值(p%)
6. bgw.ReportProcess(p)导致bgw.ProcessChanged事件被触发, 该事件的事件处理方法ProcessChangedHandle(object sender, ProgressChangedEventArgs e)被调用,其中e.ProgressPercentage值为p。需要注意的是ProcessChangedHandle运行于UI主线程上下文中
7. 在异步操作完成后我们需要得到一个结果(是一个object对象)r,我们需要将该结果付给DoWorkHandle(object sender, DoWorkEventArgs e)方法中的参数e的属性Result( e.Result =r);
8. 到了此时,异步操作完成,RunWorkerCompleted事件被触发,事件处理方法RunWorkerCompletedHandle(object sender, RunWorkerCompletedEventArgs e)被调用,我们需要检查参数e,在参数e中包含了以下信息: a. Cancelled属性,如果为true表示是由于取消方法(CancelAsync)的调用导致异步操作结束,这个时候我们需要做和取消相关的操作; b. Error属性,如果不为空,表示异步操作方法发生了异常,我们需要做和异常处理相关的操作; c.如果Cancelled属性=false并且Error属性=null,说明我们的异步操作正常结束,我们需要考察e.Result属性,这个属性的值应该为步骤7中的r,我们对该值做进一步处理
9. 如果我们需要取消异步操作,只需要调用方法bgw.CancelAsync即可以,但是需要注意的是,在调用这个方法前我们先要检查异步操作是否还在进行(如果bgw.IsBusy属性为true,说明异步操作在进行中),只有异步操作正在进行中的情况下,我们才能调用bgw.CancelAsync方法,典型代码:
if (this.backgroundWorker1.IsBusy)
{
.......
backgroundWorker1.CancelAsync();
.......
}