萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 非同步資料庫存取與 UI 更新:SqlCommand.BeginExecuteReader 配合 Invoke 完整實作

場景痛點

傳統同步 SqlCommand.ExecuteReader 會阻塞 UI 執行緒,導致視窗凍結、無法移動、甚至被系統判定為「未回應」。正確做法是:**資料庫層面真非同步 + UI 更新跨執行緒編組**。

關鍵技術點

  1. 連接字串必須加入 Asynchronous Processing=true(或 Async=true),否則 BeginExecuteReader 會拋出例外。
  2. BeginExecuteReader 立即返回,執行緒池執行緒完成查詢後呼叫回呼。
  3. 回呼執行於背景執行緒,更新 UI 必須透過 Control.Invoke 或 BeginInvoke。

完整可執行範例

using System;
using System.Data;
using System.Data.SqlClient;
using System.Windows.Forms;

namespace AsyncDbDemo
{
    public partial class MainForm : Form
    {
        // 1. 定義 UI 更新委派
        private delegate void UpdateGridDelegate(DataTable dt);

        public MainForm()
        {
            InitializeComponent();
        }

        private void btnLoad_Click(object sender, EventArgs e)
        {
            const string connStr = "Data Source=192.168.1.1;Initial Catalog=AD;User ID=sa;Password=123;Asynchronous Processing=true";
            const string sql = "SELECT TOP 100 * FROM tb_user";

            try
            {
                using (var conn = new SqlConnection(connStr))
                {
                    conn.Open(); // 同步開啟連線(開啟通常很快),或用 BeginOpen/EndOpen 完全非同步
                    using (var cmd = new SqlCommand(sql, conn))
                    {
                        // 2. 發起非同步查詢,回呼傳入 cmd 本身作為 AsyncState
                        cmd.BeginExecuteReader(OnQueryComplete, cmd);
                    }
                }
                btnLoad.Enabled = false;
                lblStatus.Text = "查詢中...";
            }
            catch (Exception ex)
            {
                MessageBox.Show($"啟動查詢失敗:{ex.Message}");
            }
        }

        // 3. 非同步回呼(執行於背景執行緒)
        private void OnQueryComplete(IAsyncResult ar)
        {
            SqlCommand cmd = null;
            SqlDataReader reader = null;
            DataTable dt = null;

            try
            {
                cmd = (SqlCommand)ar.AsyncState;
                reader = cmd.EndExecuteReader(ar); // 取得結果,若查詢失敗此處拋例外

                dt = new DataTable();
                dt.Load(reader); // 將資料載入 DataTable(記憶體中斷開連線)
            }
            catch (Exception ex)
            {
                // 背景執行緒例外無法直接顯示 UI,需編組回 UI 執行緒
                this.BeginInvoke(new Action(() => MessageBox.Show($"查詢錯誤:{ex.Message}")));
                return;
            }
            finally
            {
                reader?.Close();
                cmd?.Connection?.Close(); // 釋放連線回連線池
            }

            // 4. 跨執行緒更新 UI:檢查 InvokeRequired 再決定同步/非同步
            if (this.IsHandleCreated && !this.IsDisposed)
            {
                if (dataGridView1.InvokeRequired)
                {
                    dataGridView1.Invoke(new UpdateGridDelegate(BindGrid), dt);
                }
                else
                {
                    BindGrid(dt);
                }
            }
        }

        // 5. 真正更新 UI 的方法(保證在 UI 執行緒執行)
        private void BindGrid(DataTable dt)
        {
            dataGridView1.DataSource = dt;
            lblStatus.Text = $"載入完成,共 {dt.Rows.Count} 筆";
            btnLoad.Enabled = true;
        }
    }
}

進階優化:完全非同步開啟連線

// .NET 4.5+ 建議使用 Task-based 非同步模式 (TAP)
private async void btnLoadModern_Click(object sender, EventArgs e)
{
    const string connStr = "Data Source=192.168.1.1;Initial Catalog=AD;User ID=sa;Password=123";
    const string sql = "SELECT TOP 100 * FROM tb_user";

    btnLoadModern.Enabled = false;
    lblStatus.Text = "連線中...";

    try
    {
        using (var conn = new SqlConnection(connStr))
        {
            await conn.OpenAsync(); // 非同步開啟連線
            using (var cmd = new SqlCommand(sql, conn))
            using (var reader = await cmd.ExecuteReaderAsync()) // 非同步讀取
            {
                var dt = new DataTable();
                dt.Load(reader);
                dataGridView1.DataSource = dt;
            }
        }
        lblStatus.Text = $"載入完成,共 {dataGridView1.Rows.Count} 筆";
    }
    catch (Exception ex)
    {
        MessageBox.Show($"錯誤:{ex.Message}");
    }
    finally
    {
        btnLoadModern.Enabled = true;
    }
}
優勢:程式碼線性、例外自然冒泡、自動捕獲 UI 同步上下文、支援 CancellationToken 取消查詢、無需手寫委派與 InvokeRequired 判斷。

常見錯誤與修正

錯誤寫法後果修正
連接字串缺少 Async=trueBeginExecuteReader 拋 InvalidOperationException加入 Asynchronous Processing=true
回呼中直接 dataGridView1.DataSource = dt跨執行緒存取,可能拋例外或資料錯亂用 Invoke/BeginInvoke 編組
未檢查 IsHandleCreated/IsDisposed表單關閉時回呼觸發,存取已釋放控制項崩潰更新 UI 前檢查控制項存活
未關閉 SqlDataReader/SqlConnection連線洩漏,連線池耗盡using 或 finally 確保釋放

總結

  • **舊專案維護**:使用 BeginExecuteReader + Invoke 模式,注意連接字串、例外處理、控制項存活檢查。
  • **新專案開發**:優先採用 async/await + ExecuteReaderAsync/OpenAsync,程式碼更簡潔、維護性更高。
  • **核心原則**:資料庫 I/O 不阻塞 UI 執行緒,UI 更新必須在 UI 執行緒進行。
copyright © 萬盛學電腦網 all rights reserved