傳統同步 SqlCommand.ExecuteReader 會阻塞 UI 執行緒,導致視窗凍結、無法移動、甚至被系統判定為「未回應」。正確做法是:**資料庫層面真非同步 + UI 更新跨執行緒編組**。
Asynchronous Processing=true(或 Async=true),否則 BeginExecuteReader 會拋出例外。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=true | BeginExecuteReader 拋 InvalidOperationException | 加入 Asynchronous Processing=true |
回呼中直接 dataGridView1.DataSource = dt | 跨執行緒存取,可能拋例外或資料錯亂 | 用 Invoke/BeginInvoke 編組 |
未檢查 IsHandleCreated/IsDisposed | 表單關閉時回呼觸發,存取已釋放控制項崩潰 | 更新 UI 前檢查控制項存活 |
未關閉 SqlDataReader/SqlConnection | 連線洩漏,連線池耗盡 | using 或 finally 確保釋放 |
BeginExecuteReader + Invoke 模式,注意連接字串、例外處理、控制項存活檢查。async/await + ExecuteReaderAsync/OpenAsync,程式碼更簡潔、維護性更高。