,,

WinForm 跨線程更新界面

當前位置：點晴教程→知識管理交流 →『技術文檔交流』

admin

2025年1月22日 21:26 本文熱度 140

前言

我們在開發 C# 程序的時候，有時候需要在非UI主線程更新界面，為了避免跨線程更新UI的異常，下面進行詳細介紹如何實現這一需求！

報錯代碼

下面的代碼中的this.Text指的是一個winform的窗體，開啟Task執行下面的代碼以后直接報錯，提示線程間操作無效，這是因為在WinForms應用程序中，UI元素（如控件）通常只能在創建它們的線程（通常是主線程或UI線程）上進行操作。

如果你嘗試從另一個線程更新UI元素，將會引發跨線程操作異常（InvalidOperationException）。

為了安全地從非UI線程更新UI，你需要使用Invoke或BeginInvoke方法將更新操作封送回UI線程。

private void Test()
{
    for(int i=0;i<int.MaxValue;i++)
    {
        this.Text  = i.ToString();
        Thread.Sleep(1000);
    }
}

Task.Run(Test);

2、偷懶方法（不推薦）

在程序開始執行前設置下面的屬性，意思就是不檢查非UI線程訪問UI，這樣設置以后程序也不會報錯，但是從眾多查閱的資料可以得出該方法并不可靠，在多個線程同時并發訪問控件時，可能會導致死鎖，數據不一致等異常情況，所以并不推薦使用。

CheckForIllegalCrossThreadCalls = false;

3、正確方法（推薦）

3.1、control.Invoke（一般都是采用這種方式）

下面的代碼中this代表當前form窗體，Invoke方法里面傳入的是一個委托，這里Action就是一個委托，Action委托綁定的方法通過lamada表達式實現，lamada表達式綁定的內容就是更新 this.Text的值。

control.Invoke的作用就是在創建控件的基礎句柄所在線程上執行委托，也就是control.Invoke里面的委托更新ui的操作會被切換到ui線程執行，雖然調用 control.Invoke的代碼不在ui線程，而且必須是ui線程的代碼執行完了以后，才會重新切換到調用線程。

private void Test()
{
    this.Invoke(new Action(() =>
    {
        this.Text = "100";
        Console.WriteLine("委托執行完成");
        Thread.Sleep(1000);
    }));

    Console.WriteLine("Test方法執行完成");
}

Task.Run(Test);

輸出：

//委托執行完成
Test方法執行完成

從上面的輸出可以看出 this.Invoke綁定的委托在ui線程執行完成以后，才返回到調用線程執行Console.WriteLine(“Test方法執行完成”);，這也稱為同步調用。

3.2、control.BeginInvoke

下面的代碼中this代表當前form窗體，BeginInvoke 方法里面傳入的是一個委托，這里Action就是一個委托，Action委托綁定的方法通過lamada表達式實現，lamada表達式綁定的內容就是更新 this.Text的值。

control.BeginInvoke 的作用就是在創建控件的基礎句柄所在線程上異步執行委托，也就是control.BeginInvoke里面的委托更新ui的操作會被切換到ui線程執行，同時BeginInvoke方法立即返回，接著執行調用線程后面的代碼，而不是等到BeginInvoke綁定的委托執行完成以后才執行。

private void Test()
{
    this.BeginInvoke (new Action(() =>
    {
        this.Text = "100";
        Console.WriteLine("委托執行完成");
        Thread.Sleep(1000);
    }));
    Console.WriteLine("Test方法執行完成");
}