BackgroundWorker 組件深度使用指南：事件流、參數傳遞與線程邊界

VS 2005 引入的 BackgroundWorker 大幅簡化 WinForms 多線程開發，但其事件流與參數傳遞機制若不清晰，極易踩坑。本文梳理完整生命週期、三次關鍵參數傳遞、UI 線程邊界規則。

核心成員速查

三次關鍵參數傳遞

1. 啟動參數：RunWorkerAsync(obj) → DoWorkEventArgs.Argument。建議封裝為上下文類實例。
2. 進度參數：ReportProgress(%, userState) → ProgressChangedEventArgs.ProgressPercentage / UserState。用於更新進度條、日誌。
3. 結果參數：DoWorkEventArgs.Result = result → RunWorkerCompletedEventArgs.Result。攜帶後台計算結果回 UI 線程。

線程邊界鐵律

• DoWork 運行於後台線程，嚴禁直接操作 UI 控件（會拋出跨線程異常）。
• ProgressChanged、RunWorkerCompleted 由組件自動封送至UI 線程，安全操作 UI。

標準使用模板

private void btnStart_Click(object sender, EventArgs e)
{
    if (bw.IsBusy) return;
    bw.RunWorkerAsync(new WorkContext { Input = txtInput.Text });
}

private void bw_DoWork(object sender, DoWorkEventArgs e)
{
    var ctx = (WorkContext)e.Argument;
    for (int i = 0; i < 100; i++)
    {
        if (bw.CancellationPending) { e.Cancel = true; return; }
        // 耗時計算...
        bw.ReportProgress(i, $"Step {i} done");
    }
    e.Result = ctx.Output; // 設置結果
}

private void bw_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
    pgb.Value = e.ProgressPercentage;
    lstLog.Items.Add(e.UserState);
}

private void bw_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
    if (e.Cancelled) MessageBox.Show("已取消");
    else if (e.Error != null) MessageBox.Show("錯誤: " + e.Error.Message);
    else txtResult.Text = e.Result.ToString();
}

避坑提示

• 啟用 WorkerSupportsCancellation = true 後，DoWork 中必須輪詢 CancellationPending 並設置 e.Cancel = true。
• 異常處理：RunWorkerCompleted 中檢查 e.Error，DoWork 中未捕獲的異常會自動封送至此。
• 重入防護：IsBusy 防止重複啟動。