BackgroundWorker 能够用于启动后台线程。编程
主要的事件及参数:
1.DoWork——当执行BackgroundWorker.RunWorkerAsync方法时会触发该事件,而且传递DoWorkEventArgs参数;多线程
2.RunWorkerCompleted——异步操做完成或中途终止会触发该事件。异步
若是须要提早终止执行后台操做,能够调用BackgroundWorker.CancelAsync方法。函数
在处理DoWork事件的函数中检测BackgroundWorker.CancellationPending属性是否为true,若是是true,则表示用户已经取消了异步调用,同时将DoWorkEventArgs.Cancel属性设为true(传递给处理DoWork事件的函数的第二个参数),这样当退出异步调用的时候,可让处理RunWorkerCompleted事件的函数知道是正常退出仍是中途退出。
3.ProgressChanged——操做处理中得到的处理状态变化,经过BackgroundWorker.ReportProgress(int)方法触发该事件,而且传递ProgressChangedEventArgs,其中包含了处理的百分比,这个参数在UI界面上设置progressbar控件。 this
主要的方法:
1. BackgroundWorker.RunWorkerAsync——“起动”异步调用的方法有两次重载RunWorkerAsync(),RunWorkerAsync(object argument),第二个重载提供了一个参数,能够供异步调用使用。(若是有多个参数要传递怎么办,使用一个类来传递他们吧)。调用该方法后会触发DoWork事件,而且为处理DoWork事件的函数传递DoWorkEventArg参数,其中包含了RunWorkerAsync传递的参数。在相应DoWork的处理函数中就能够作具体的复杂操做。
2. BackgroundWorker.ReportProgress——须要在一个冗长的操做中向用户不断反馈进度,这样的话就能够调用的ReportProgress(int percent),在调用 ReportProgress 方法时,触发ProgressChanged事件。提供一个在 0 到 100 之间的整数,它表示后台活动已完成的百分比。你也能够提供任何对象做为第二个参数,容许你 给事件处理程序传递状态信息。做为传递到此过程的 ProgressChangedEventArgs 参数属性,百分比和你本身的对象(若是提供的话)均要被传递到 ProgressChanged 事件处理程序。这些属性被分别命名为 ProgressPercentage 和 UserState,而且你的事件处理程序能够以任何须要的方式使用它们。(注意:只有在BackgroundWorker.WorkerReportsProgress属性被设置为true该方法才可用)。
3. BackgroundWorker.CancelAsync——但须要退出异步调用的时候,就调用的这个方法。可是样还不够,由于它仅仅是将BackgroudWorker.CancellationPending属性设置为true。你须要在具体的异步调用处理的时候,不断检查BackgroudWorker.CancellationPending是否为true,若是是真的话就退出。(注意:只有在BackgroundWorker.WorkerSupportsCancellation属性被设置为true该方法才可用)。spa
public
partial
class
MainWindow : Window
{
private
BackgroundWorker m_BackgroundWorker;
// 申明后台对象
public
MainWindow()
{
InitializeComponent();
m_BackgroundWorker =
new
BackgroundWorker();
// 实例化后台对象
m_BackgroundWorker.WorkerReportsProgress =
true
;
// 设置能够通告进度
m_BackgroundWorker.WorkerSupportsCancellation =
true
;
// 设置能够取消
m_BackgroundWorker.DoWork +=
new
DoWorkEventHandler(DoWork);
m_BackgroundWorker.ProgressChanged +=
new
ProgressChangedEventHandler(UpdateProgress);
m_BackgroundWorker.RunWorkerCompleted +=
new
RunWorkerCompletedEventHandler(CompletedWork);
m_BackgroundWorker.RunWorkerAsync(
this
);
}
void
DoWork(
object
sender, DoWorkEventArgs e)
{
BackgroundWorker bw = sender
as
BackgroundWorker;
MainWindow win = e.Argument
as
MainWindow;
int
i = 0;
while
( i <= 100 )
{
if
(bw.CancellationPending)
{
e.Cancel =
true
;
break
;
}
bw.ReportProgress(i++);
Thread.Sleep(1000);
}
}
void
UpdateProgress(
object
sender, ProgressChangedEventArgs e)
{
int
progress = e.ProgressPercentage;
label1.Content =
string
.Format(
"{0}"
,progress);
}
void
CompletedWork(
object
sender, RunWorkerCompletedEventArgs e)
{
if
( e.Error !=
null
)
{
MessageBox.Show(
"Error"
);
}
else
if
(e.Cancelled)
{
MessageBox.Show(
"Canceled"
);
}
else
{
MessageBox.Show(
"Completed"
);
}
}
private
void
button1_Click(
object
sender, RoutedEventArgs e)
{
m_BackgroundWorker.CancelAsync();
}
}
|