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();
}
}
|