DataAdapter
SqlDataAdapter：DataSet與SQL Server之間的橋接器(中介角色)。
把DataAdapter 物件所執行的 SQL命令的結果 填入 DataSet 中，並更新解析回 DB
用SqlDataAdapter的 Fill方法時會自動開啟資料庫連接，並在方法執行完畢自動關閉連線。
- SqlDataAdapter 類別代表一組資料命令和資料庫連線，用來填入 DataSet 並更新 SQL Server 資料庫。 此類別無法獲得繼承。
- DataSet 類別 代表資料的記憶體內部快取。
1
2
3
4
5
6
// Assumes that connection is a valid SqlConnection object.
string queryString = "SELECT CustomerID, CompanyName FROM dbo.Customers";
SqlDataAdapter adapter = new SqlDataAdapter(queryString, connection);
DataSet customers = new DataSet();
adapter.Fill(customers, "Customers");
注意
這個範例所顯示的程式碼並未明確開啟和關閉 Connection。 Fill 方法若發現連接尚未開啟，會隱含開啟 Connection 正在使用的 DataAdapter 。 如果 Fill 開啟了連接，則當 Fill 結束時也會一併關閉連接。 如此便可在處理單一作業時 (例如 Fill 或 Update)，簡化您的程式碼。 但是，如果您要執行需要開啟連接的多項作業，您可明確呼叫 Open 的 Connection方法，針對資料來源執行作業，然後呼叫 Close 的 Connection方法，如此即可改善應用程式的效能。 您應該儘量減少與資料來源之間的連接，以釋放資源給其他用戶端應用程式使用。
用SqlDataAdapter的Fill方法時會自動開啟資料庫連接，並在方法執行完畢自動關閉連線。
DataAdapter.Fill() 會自動開啟關閉DB
看MSDN上的DataAdapter.Fill的說明：
Fill 方法使用相關的 SelectCommand 屬性所指定的 SELECT 陳述式，從資料來源擷取資料列。與 SELECT 陳述式關聯的連接物件必須是有效的，但不需要是開啟的。如果在呼叫 Fill 之前關閉連接，它會先開啟以擷取資料，然後再關閉。如果在呼叫 Fill 之前開啟連接，它會保持開啟。
原來DataAdapter會在需要時自動Open connection並在不需要時自動Close connection
填入資料 & 取出資料
1
2
3
4
SqlDataAdapter adapter = new SqlDataAdapter(sql, conn);
DataSet ds = new(); //用來存放DataAdapter執行sql 的結果
adapter.Fill(ds); //填入dataSet, ds.Tables[0] 就是你所要查詢的結果集
string id = dt.Rows[0]["id"].ToString(); //dt.Rows[0]表示第一行資料，table.Rows[0]["id"]表示table中列id的值
當adapter.Fill(dataSet);執行後，程式會透過SQL引擎回傳一個結果集存放在記憶體中，這個結果集就是一個DataTable,並且這個DataTable會被添加到ds.Tables中，所以 ds.Tables[0]，就是你所要查詢的結果集。
table.Rows[0]表示table的第一行數據，table.Rows[0]["id"]表示table中列id的值，
table的所有列是你在SQL中所查詢的所有列
寫法一：將資料放入DataTable中
1
2
3
4
5
6
7
8
//建立 DataAdapter 來執行sql語句，並告訴它是連接哪個db
SqlDataAdapter da = new(sql, conn)
//建立DataTable，用來存放DataAdapter執行sql 的結果
DataTable dt = new();
//DataAdapter呼叫Fill方法，Fill 會將執行sql 的結果 放入DataTable中
da.Fill(dt);
直接把資料放入 DataTable 中
取資料時用: dt.Rows
(第一行第一列dt.Rows[0][0]，第一行第二列dt.Rows[0][1])
寫法二：將資料放入DataSet中
資料结果放到dataset中，若要用哪個datatable，可以這樣：dataset[0]
1
2
3
4
5
6
7
8
//建立 DataAdapter 來執行sql語句，並告訴它是連接哪個db
SqlDataAdapter da = new(sql, conn)
//建立DataSet，用來存放DataAdapter執行sql 的結果
DataSet ds = new();
//DataAdapter呼叫Fill方法，Fill 會將執行sql 的結果 放入DataSet中
da.Fill(ds); // 或者加上table名 da.Fill(ds,"emp")
數據結果放到DataSet中，若要用到哪個table，
可以這樣取：ds.Tables[0]
(第一行第一列ds.Tables[0].Rows[0][0]，第一行第二列ds.Tables[0].Rows[0][0])
或者 加上填入dataset時 加上table名：
1
2
3
4
5
6
7
8
//建立 DataAdapter 來執行sql語句，並告訴它是連接哪個db
SqlDataAdapter da = new(sql, conn)
//建立DataSet，用來存放DataAdapter執行sql 的結果
DataSet ds = new();
//DataAdapter呼叫Fill方法，Fill 會將執行sql 的結果 放入DataSet中
da.Fill(ds, "employee");
用的時這樣取：ds.Tables["employee"]
範例1: 資料放入DataTable
- 使用 SqlDataAdapter 來執行 sql 語法
- 將執行sql命令的資料結果 放入DataTable 中
- 從 DataTable 取出資料
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
string connString = "Data Source=.;Initial catalog=DBTEST;User id=riva;Password=1234;Encrypt=true;Trust Server Certificate=True";
//建立db連接
using (SqlConnection conn = new(connString))
{
//用SqlDataAdapter的Fill方法時會自動開啟資料庫連接，並在方法執行完畢自動關閉連線。(所以不用寫conn.open/conn.close)
//if (conn.State != ConnectionState.Open) conn.Open();
//建立 DataAdapter 來執行sql語句，並告訴它是連接哪個db
SqlDataAdapter da = new("select * from emp", conn)
//建立DataTable，用來存放DataAdapter執行sql 的結果
DataTable dt = new();
//DataAdapter呼叫Fill方法，Fill 會將執行sql 的結果 放入DataTable中
da.Fill(dt);
//將資料從datatable取出，並輸出到控制台上
//1.顯示第一筆資料
Console.WriteLine($"編號：{dt.Rows[0][0]}, 姓名：{dt.Rows[0][1]}");
//2.顯示全部資料: 兩次迴圈
foreach (DataRow row in dt.Rows) {
foreach (DataColumn column in dt.Columns) {
Console.WriteLine($"{row[column]}");
}
}
//3.如果想把某列的值拼接字串，那就去掉内層循环就行了
foreach (DataRow row in dt.Rows) {
Console.WriteLine($"編號：{row["EmpId"]}, 姓名：{row["EmpName"]}");
}
}
dt.Rows[0]表示第一行資料dt.Rows[0][0]表示table中第一行第一列的值dt.Rows[0][1]表示table中第一行第二列的值
執行結果： 顯示第一筆資料
1
編號：1, 姓名：張三
遍歷 DataTable
要顯示全部資料，只要做兩次循環即可：
1
2
3
4
5
6
7
foreach (DataRow row in dt.Rows)
{
foreach (DataColumn column in dt.Columns)
{
Console.WriteLine($"{column}:{row[column]}");
}
}
row[column] 中的column是檢索出來的表列名
執行結果：
1
2
3
4
EmpId：1
EmpName：張三
EmpId：2
EmpName：李四
如果想把某列的值拼接字串，那就去掉内層循环就行了：
1
2
3
4
foreach (DataRow row in dt.Rows)
{
Console.WriteLine($"編號：{row["EmpId"]}, 姓名：{row["EmpName"]}");
}
執行結果：
1
2
3
編號：1, 姓名：張三
編號：2, 姓名：李四
編號：3, 姓名：王五
範例2: 資料放入DataSet
- 使用 SqlDataAdapter 來執行 sql 語法
- 將執行sql命令的資料結果 放入DataSet 中
- 從 DataTable 中取出一筆資料
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
string connString = "Data Source=.;Initial catalog=DBTEST;User id=riva;Password=1234;Encrypt=true;Trust Server Certificate=True";
//建立db連接
using (SqlConnection conn = new(connString))
{
//建立 DataAdapter 來執行sql語句，並告訴它是連接哪個db
SqlDataAdapter da = new("select * from emp", conn))
//建立DataSet，用來存放DataAdapter執行sql 的結果
DataSet ds = new();
//DataAdapter呼叫Fill方法，Fill 會將執行sql 的結果 放入DataSet中
da.Fill(ds); //或是 加上table名： da.Fill(ds,"Emp"); 取值：ds.Tables["Emp"].Rows[0][0]
//從DataSet將資料取出，並輸出到控制台上。或是 ds.Tables["Emp"].Rows[0][0]
Console.WriteLine($"編號：{ds.Tables[0].Rows[0][0]}, 姓名：{ds.Tables[0].Rows[0][1]}");
}
資料填入DataSet時，可以加上 Table名：da.Fill(ds,"Employee");
取值時，同樣也加上Table名：ds.Tables["Employee"].Rows[0][0]
執行結果：
1
編號：1, 姓名：張三
DataSet & DataTable
可以把DataTable和DataSet看做是資料容器，例如你查詢資料庫後面得到一些結果，可以放到這種容器裡。
那你可能要問：我不用這種容器，自己讀到變數或陣列裡也一樣可以存起來啊，為什麼要用容器？
原因是，這種容器的功能比較強大，除了可以存數據，還可以有更大用途。
舉例：在一個c/s結構的桌面資料庫系統裡，你可以把前面存放查詢結果的容器裡的資料顯示到你客戶端介面上，使用者在介面上對資料進行新增、刪除、修改，你可以把使用者的操作更新到容器，等使用者操作完畢了，要求更新，然後你才把容器整個的資料變化更新到資料庫，
這樣做的好處是什麼？就是減少了資料庫操作，客戶端速度提高了，資料庫壓力減少了。
DataSet 可以比喻為一個記憶體中的資料庫，DataTable 是一個記憶體中的資料表，DataSet裡可以儲存多個DataTable。
- DataSet：資料集。一般包含多個DataTable，用的時候，dataset[“表名”]得到 DataTable
- DataTable：資料表。
注意
如果只需要執行SQL語句或SP，就沒必要用到DataAdapter，直接用SqlCommand的Execute系列方法就可以了。 sqlDataadapter的作用是實作Dataset和DB之間的橋樑：例如將對DataSet的修改更新到資料庫。
MSDN - 從 DataAdapter 填入資料集
MSDN - SqlDataAdapter 類別
MSDN - DataSet 類別 C#之DataSet和DataTable
[C#]DataAdapter的有趣現象
C#中Sql DataAdapter的使用