萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MS SQL 資料庫

C# SqlDataAdapter 核心用法詳解:三種創建方式、Fill/Update 機制、TableMapping、連接管理與避坑指南

SqlDataAdapter 定位

DataSet 與 SQL Server 之間的橋接器,封裝 SELECT/INSERT/UPDATE/DELETE 四條命令,實現離線數據集的填充與更新回寫。

三種創建方式

1. 連接字符串 + SQL(最簡單,但每實例創建新連接)

string connStr = "Server=.;Database=Test;Uid=sa;Pwd=123;";
string sql = "SELECT * FROM Customers";
var da = new SqlDataAdapter(sql, connStr);
var ds = new DataSet();
da.Fill(ds, "Customers");

2. 共享 SqlConnection(推薦多 DataAdapter 共用連接)

var conn = new SqlConnection(connStr);
var da1 = new SqlDataAdapter("SELECT * FROM Customers", conn);
var da2 = new SqlDataAdapter("SELECT * FROM Orders", conn);
var ds = new DataSet();
conn.Open();           // 手動打開
da1.Fill(ds, "Customers");
da2.Fill(ds, "Orders"); // 同一連接複用,避免多次開關
conn.Close();

3. SqlCommand 對象(靈活控制命令屬性、參數、事務)

var conn = new SqlConnection(connStr);
var cmd = new SqlCommand("SELECT * FROM Customers WHERE Region=@Region", conn);
cmd.Parameters.AddWithValue("@Region", "WA");
var da = new SqlDataAdapter(cmd);
var ds = new DataSet();
da.Fill(ds, "Customers");

Fill 機制與 TableMapping

  • Fill(DataSet) 默認創建表名 Table, Table1...,非業務友好。
  • 方案 A:da.Fill(ds, "Customers") 指定 DataTable 名稱(最簡潔)。
  • 方案 B:da.TableMappings.Add("Table", "Customers") 映射默認名。

UpdateCommand 執行機制

  • 調用 da.Update(ds, "Customers") 時,遍歷 DataTable 所有行的 RowState。
  • 僅對 Added/Modified/Deleted 行分別執行 InsertCommand/UpdateCommand/DeleteCommand。
  • 未修改行不執行任何命令。
  • 命令中的參數自動映射到行的列值(SourceColumn 屬性)。

連接管理最佳實踐

  • Fill 會自動打開關閉 連接(若調用時連接關閉),執行完恢復原狀態。
  • 批量填充多表時,手動 Open 一次,填充完再 Close,避免 N 次開關開銷。
  • 事務中使用:da.SelectCommand.Transaction = tran,Fill 參與事務;Update 同理。

避坑指南

  1. 重複 Fill 導致數據疊加:第二次 Fill 會追加行而非刷新。
    對策:ds.Tables["Customers"].Clear() 或 ds.Tables["Customers"].Rows.Clear() 後再 Fill;或設置 PrimaryKey 讓合併邏輯生效(需主鍵列)。
  2. 外部刪除行不同步:DB 中行被刪,再次 Fill 不會自動移除 DataSet 中對應行。
    對策:重新 Fill 前 Clear(),或用 Merge 策略(ds.Merge(newData, false, MissingSchemaAction.Ignore))。
  3. CommandBuilder 陷阱:new SqlCommandBuilder(da) 自動生成命令要求 單表、有主鍵、無別名、列名無特殊字符。複雜場景手寫命令更可控。
  4. 並發衝突:Update 時若行已被他人修改(樂觀鎖),拋 DBConcurrencyException。需捕獲並刷新/合併策略。

何時不用 SqlDataAdapter

  • 僅執行 DDL/單條 DML/標量查詢 → 直接用 SqlCommand.ExecuteNonQuery/ExecuteScalar/ExecuteReader。
  • 高性能流式讀取 → SqlDataReader(只進、只讀、低內存)。
  • 實體映射 → Dapper/EF Core 等 ORM/Micro-ORM。
copyright © 萬盛學電腦網 all rights reserved