萬盛學電腦網

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

深入掌握 ADO.NET SqlDataAdapter 核心功能與用法

什麼是 SqlDataAdapter?

SqlDataAdapter 是 ADO.NET 中連接 DataSet(離線資料容器)與 SQL Server 資料庫的橋樑。它封裝了四條核心命令(SelectCommand、InsertCommand、UpdateCommand、DeleteCommand),負責將資料從資料庫填入 DataSet,並將 DataSet 的變更批次更新回資料庫。

核心特點

  • 離線架構:Fill() 執行完畢後,DataSet 與資料庫連線即斷開,適合高併發、可擴展的應用。
  • 批次更新:Update() 會檢查 DataRow.RowState,自動生成對應的 INSERT/UPDATE/DELETE 語句執行。
  • 資料表映射:透過 TableMappings 將資料庫表名映射為自訂 DataTable 名稱。

建立 SqlDataAdapter 的三種常見方式

1. 獨立構造命令與連線

string sql = "SELECT * FROM Customers";
SqlCommand cmd = new SqlCommand(sql, conn);
SqlDataAdapter da = new SqlDataAdapter();
da.SelectCommand = cmd;

2. 直接傳入 SQL 與連線字串

string connStr = "Server=.;Database=Northwind;Integrated Security=true";
string sql = "SELECT * FROM Customers";
SqlDataAdapter da = new SqlDataAdapter(sql, connStr);

3. 傳入 SQL 與 SqlConnection 物件

SqlConnection conn = new SqlConnection(connStr);
SqlDataAdapter da = new SqlDataAdapter("SELECT * FROM Customers", conn);

Fill 方法詳細用法

基本填充

DataSet ds = new DataSet();
da.Fill(ds); // 預設表名為 "Table"

自訂 DataTable 名稱

da.TableMappings.Add("Table", "Customers");
da.Fill(ds); // ds.Tables["Customers"] 可用

指定表名填充

da.Fill(ds, "Customers");

分頁載入(僅讀取指定範圍)

// 從第 0 筆開始,取 10 筆
da.Fill(ds, 0, 10, "Customers");

連線管理最佳實踐

// 手動控制連線:適合同一連線多次 Fill,減少開關開銷
conn.Open();
daCustomers.Fill(ds);
daOrders.Fill(ds);
conn.Close();

刷新 DataSet 資料

最簡單方式:ds.Tables["Customers"].Clear(); da.Fill(ds);。或使用 da.Fill(ds, "Customers") 覆寫(需注意主鍵衝突)。

屬性、方法與事件速查表

分類成員說明
屬性SelectCommand查詢命令(必填)
InsertCommand新增命令
UpdateCommand更新命令
DeleteCommand刪除命令
TableMappings結果集與 DataTable 對應集合
ContinueUpdateOnError遇錯誤是否繼續更新(預設 false)
AcceptChangesDuringFillFill 時是否 AcceptChanges(預設 true)
方法Fill執行 SelectCommand 並填充 DataSet/DataTable
FillSchema僅取得結構描述(欄位名、型別)
Update批次提交 DataSet 變更,回傳影響列數
GetFillParameters取得 SelectCommand 參數陣列
事件FillError填充發生錯誤時觸發
RowUpdating更新前觸發,可修改命令/取消
RowUpdated更新後觸發,可檢查結果/錯誤

DbDataAdapter.Fill 多載一覽

繼承自 DbDataAdapter 的 Fill 提供豐富多載,支援 DataSet、DataTable、IDataReader、IDbCommand 等組合,滿足不同資料來源與分頁需求。

實戰建議

  1. 搭配 SqlCommandBuilder 自動生成 Insert/Update/Delete 命令(僅限單表、有主鍵)。
  2. 大量資料更新時,考慮 SqlBulkCopy 或分批 Update 避免記憶體壓力。
  3. 善用 RowUpdating/RowUpdated 事件實作樂觀並發、審計日誌等進階邏輯。
copyright © 萬盛學電腦網 all rights reserved