C# WinForms 安全多線程編程：Invoke/BeginInvoke 模式完整指南

問題背景

WinForms 控件非線程安全，必須在創建它們的 UI 線程上訪問。耗時操作（計算、IO、網絡）若在 UI 線程執行會導致界面凍結、無法重繪（如文章中的 Pi 計算示例）。

核心模式：異步委托 + Invoke/BeginInvoke

步驟 1：定義 UI 更新委托

// 簽名與 UI 更新方法一致
private delegate void ShowProgressDelegate(string text, int total, int current);

步驟 2：工作線程中調用 BeginInvoke

private void CalcPi(int digits)
{
    var sb = new StringBuilder("3", digits + 2);
    var showProgress = new ShowProgressDelegate(ShowProgress);
    
    // 初始進度
    this.BeginInvoke(showProgress, sb.ToString(), digits, 0);
    
    if (digits > 0)
    {
        sb.Append(".");
        for (int i = 0; i < digits; i += 9)
        {
            // ... 計算 9 位數字 ...
            int nineDigits = ComputeNineDigits(i + 1);
            int count = Math.Min(digits - i, 9);
            sb.Append(nineDigits.ToString($"D9").Substring(0, count));
            
            // 異步更新 UI，不阻塞工作線程
            this.BeginInvoke(showProgress, sb.ToString(), digits, i + count);
        }
    }
}

步驟 3：UI 更新方法內部線程檢查 (可選但推薦)

private void ShowProgress(string pi, int totalDigits, int digitsSoFar)
{
    // 如果已在 UI 線程，直接執行；否則 BeginInvoke 會排隊執行此方法
    if (this.InvokeRequired)
    {
        // 理論上 BeginInvoke 已保證在 UI 線程，此處作為防禦性編程
        this.BeginInvoke(new ShowProgressDelegate(ShowProgress), pi, totalDigits, digitsSoFar);
        return;
    }
    
    // 安全更新控件
    txtPi.Text = pi;
    progressBar.Maximum = totalDigits;
    progressBar.Value = digitsSoFar;
}

步驟 4：啟動工作線程

private void btnCalc_Click(object sender, EventArgs e)
{
    int digits = (int)numDigits.Value;
    // 方式一：ThreadPool (推薦簡短任務)
    ThreadPool.QueueUserWorkItem(_ => CalcPi(digits));
    
    // 方式二：Task (現代首選，.NET 4.0+)
    // Task.Run(() => CalcPi(digits));
    
    // 方式三：BackgroundWorker (舊版組件，含進度/取消事件)
    // bgWorker.RunWorkerAsync(digits);
}

Invoke vs BeginInvoke 深度對比

現代最佳實踐：async/await + Progress<T> (.NET 4.5+)

private async void btnCalc_Click(object sender, EventArgs e)
{
    btnCalc.Enabled = false;
    try
    {
        // Progress 自動捕獲 UI 同步上下文，回調在 UI 線程執行
        var progress = new Progress(p => 
        {
            txtPi.Text = p.CurrentText;
            progressBar.Value = p.DigitsDone;
        });
        
        await Task.Run(() => CalcPiAsync((int)numDigits.Value, progress));
    }
    finally
    {
        btnCalc.Enabled = true;
    }
}

private void CalcPiAsync(int digits, IProgress progress)
{
    var sb = new StringBuilder("3", digits + 2);
    progress.Report(new PiProgress(sb.ToString(), digits, 0));
    
    if (digits > 0)
    {
        sb.Append(".");
        for (int i = 0; i < digits; i += 9)
        {
            // 計算...
            sb.Append(/* 9位數字 */);
            progress.Report(new PiProgress(sb.ToString(), digits, i + 9));
        }
    }
}

record PiProgress(string CurrentText, int TotalDigits, int DigitsDone);

優勢：無需手動 Invoke、自動上下文捕獲、異常自然冒泡、代碼線性易讀、支持取消 (CancellationToken)。

進階主題

跨線程調用控件屬性讀取

// 錯誤：直接在工作線程讀取 txtInput.Text 可能拋異常或讀到舊值
// 正確：Invoke 獲取
string input = (string)this.Invoke(() => txtInput.Text);

控件創建線程親和性

• 控件句柄 (Handle) 在首次訪問時創建，綁定當前線程
• 在非 UI 線程 `new TextBox()` 後再 `Controls.Add` 會導致 Handle 在錯誤線程創建
• 規則：所有控件實例化、訪問、修改必須在 UI 線程

避免共享狀態：傳遞數據副本而非引用

文章強調：工作線程與 UI 線程間傳遞 值類型、不可變對象、或深拷貝副本，避免共享可變對象（如 StringBuilder、List）導致競態條件。若必須共享，使用 `lock`、`ConcurrentQueue`、`ImmutableArray` 等線程安全結構。

常見錯誤清單

1. 在工作線程直接 `control.Property = value` → 必須 Invoke
2. 用 `Invoke` 導致死鎖 (UI 線程 `Join` 工作線程，工作線程 `Invoke` UI) → 用 BeginInvoke/async
3. `BeginInvoke` 後不 `EndInvoke` → 內存洩漏 (APM 模式) → 無返回值時可忽略，但現代用 Task
4. 在構造函數/Load 事件前訪問 `InvokeRequired` → Handle 未創建返回 false，誤以為在 UI 線程 → HandleCreated 後再用
5. 頻繁 `BeginInvoke` 導致消息隊列堆積、UI 卡頓 → 節流/合併更新 (如 100ms 一次)

總結

WinForms 多線程核心鐵律：耗時操作放後台，UI 更新回主線程。從 `Invoke/BeginInvoke` 到 `BackgroundWorker`，再到現代 `async/await + Progress`，本質皆是同步上下文切換。新項目請直接使用 `async/await`，舊代碼維護時理解 `InvokeRequired` 與 `BeginInvoke` 機制即可。牢記「傳副本、不共享可變狀態」能避開 90% 的並發 Bug。