SqlDataAdapter 是 ADO.NET 中連接 DataSet(離線資料容器)與 SQL Server 資料庫的橋樑。它封裝了四條核心命令(SelectCommand、InsertCommand、UpdateCommand、DeleteCommand),負責將資料從資料庫填入 DataSet,並將 DataSet 的變更批次更新回資料庫。
Fill() 執行完畢後,DataSet 與資料庫連線即斷開,適合高併發、可擴展的應用。Update() 會檢查 DataRow.RowState,自動生成對應的 INSERT/UPDATE/DELETE 語句執行。TableMappings 將資料庫表名映射為自訂 DataTable 名稱。string sql = "SELECT * FROM Customers";
SqlCommand cmd = new SqlCommand(sql, conn);
SqlDataAdapter da = new SqlDataAdapter();
da.SelectCommand = cmd;
string connStr = "Server=.;Database=Northwind;Integrated Security=true";
string sql = "SELECT * FROM Customers";
SqlDataAdapter da = new SqlDataAdapter(sql, connStr);
SqlConnection conn = new SqlConnection(connStr);
SqlDataAdapter da = new SqlDataAdapter("SELECT * FROM Customers", conn);
DataSet ds = new DataSet();
da.Fill(ds); // 預設表名為 "Table"
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();
最簡單方式:ds.Tables["Customers"].Clear(); da.Fill(ds);。或使用 da.Fill(ds, "Customers") 覆寫(需注意主鍵衝突)。
| 分類 | 成員 | 說明 |
|---|---|---|
| 屬性 | SelectCommand | 查詢命令(必填) |
| InsertCommand | 新增命令 | |
| UpdateCommand | 更新命令 | |
| DeleteCommand | 刪除命令 | |
| TableMappings | 結果集與 DataTable 對應集合 | |
| ContinueUpdateOnError | 遇錯誤是否繼續更新(預設 false) | |
| AcceptChangesDuringFill | Fill 時是否 AcceptChanges(預設 true) | |
| 方法 | Fill | 執行 SelectCommand 並填充 DataSet/DataTable |
| FillSchema | 僅取得結構描述(欄位名、型別) | |
| Update | 批次提交 DataSet 變更,回傳影響列數 | |
| GetFillParameters | 取得 SelectCommand 參數陣列 | |
| 事件 | FillError | 填充發生錯誤時觸發 |
| RowUpdating | 更新前觸發,可修改命令/取消 | |
| RowUpdated | 更新後觸發,可檢查結果/錯誤 |
繼承自 DbDataAdapter 的 Fill 提供豐富多載,支援 DataSet、DataTable、IDataReader、IDbCommand 等組合,滿足不同資料來源與分頁需求。
SqlCommandBuilder 自動生成 Insert/Update/Delete 命令(僅限單表、有主鍵)。SqlBulkCopy 或分批 Update 避免記憶體壓力。RowUpdating/RowUpdated 事件實作樂觀並發、審計日誌等進階邏輯。