SqlDataAdapter 類 表示用于填充 DataSet 和更新 SQL Server 數據庫的一組數據命令和一個數據庫連接。無法繼承此類。 命名空間:System.Data.SqlClient 程序集:System.Data(在 system.data.dll 中) SqlDataAdapter 是 DataSet 和 SQL Server 之間的橋接器,用于檢索和保存數據。SqlDataAdapter 通過對數據源使用適當的 Transact-SQL 語句映射 Fill(它可更改 DataSet 中的數據以匹配數據源中的數據)和 Update(它可更改數據源中的數據以匹配 DataSet 中的數據)來提供這一橋接。 當 SqlDataAdapter 填充 DataSet 時,它為返回的數據創建必需的表和列(如果這些表和列尚不存在)。但是,除非 MissingSchemaAction 屬性設置為 AddWithKey,否則這個隱式創建的架構中不包括主鍵信息。也可以使用 FillSchema,讓 SqlDataAdapter 創建 DataSet 的架構,并在用數據填充它之前就將主鍵信息包括進去。有關更多信息,請參見 向 DataSet 添加現有約束。 SqlDataAdapter 與 SqlConnection 和 SqlCommand 一起使用,以便在連接到 SQL Server 數據庫時提高性能。 SqlDataAdapter 還包括 SelectCommand、InsertCommand、DeleteCommand、UpdateCommand 和 TableMappings 屬性,以便于數據的加載和更新。 當創建 SqlDataAdapter 的實例時,讀/寫屬性將被設置為初始值。
一.SqlDataAdapter對象
1. SqlDataAdapter特性
SqlDataAdapter類用作ADO.NET對象模型中和數據連接部分和未連接部分之間的橋梁。SqlDataAdapter從數據庫中獲取數據,并將其存儲在DataSet中。SqlDataAdapter也可能取得DataSet中的更新,并將它們提交給數據庫。
SqlDataAdapter是為處理脫機數據而設計的,調用其Fill方法填充DataSet時甚至不需要與數據庫的活動連接。即如果調用Fill方法時,SqlDataAdapter與數據庫的連接不是打開時,SqlDataAdapter將打開數據庫連接,查詢數據庫,提取查詢結果,將查詢結果填入DataSet,然后關閉也數據庫的連接。
2. SqlDataAdapter的設置
SqlCommand屬性
SqlDataAdapter將查詢結果存儲到DataSet中時,SqlDataAdapter使用SqlCommand和SqlConnection與數據庫進行通信。SqlDataAdapter在內部使用SqlDataReader獲取結果,并將信息存儲到DataSet的新行。SqlCommand類的屬性包括SelectCommand、InsertCommand、UpdateCommand、DeleteCommand分別對應數據庫的查詢、插入、更新和刪除操作。
TabbleMappings集合
默認情況下,SqlDataAdapter假定SqlDataReader中的列與DataSet中的列匹配,但實際情況中往往期望DataSet的架構不同于數據庫的架構,因此SqlDataAdapter提供了一種將查詢結果映射到DataSet結果的機制:TableMappings集合。
SqlDataAdapter的TableMappings屬性返回一個DataTableMappingsConnention對象,它包含DataTableMapping對象的集合。每個對象允許在數據庫中的一個表(或視圖或存儲過程)與DataSet中相對應的DataTable的名稱之間建立一種映射;TableMappings對象具有ColumnMappings屬性,它返回DataColumnMappings對象組成的集合,每個DataColumnMappings對象對應數據庫查詢結果中的一列映射到DataSet中DataTable中的一列。示例代碼如下:
Using System.Data.Common; SqlDataAdapter da=new SqlDataAdapter(); //初始化DataAdapter DataTableMapping tableMap; tableMap=da.TableMappings.Add(“Table”,”Employees”); tableMap.ColumnMappings.Add(“EmpID”,”EmployeeID”); tableMap.ColumnMappings.Add(“LName”,”LastName”);
二.SqlDataAdapter的創建與使用
1. 創建SqlDataAdapter
New 關鍵字
New 關鍵字建立新的SqlDataAdapter對象后,再設置其SqlCommand屬性
SqlDataAdapter da=new SqlDataAdapter(); da.SelectCommand=cmd;
SqlDataAdapter的構造函數
strSql是查詢數符串;strConn是數據庫連接字符串;cmd是SqlCommand對象;cn是SqlConnection對象。
SqlDataAdapter da=new SqlDataAdapter(strSql,strConn); SqlDataAdapter da=new SqlDataAdapter(strSql,cn); SqlDataAdapter da=new SqlDataAdapter(cmd);
執行以上代碼后,DataSet的實例對象ds中會創建一個新的DataTable,這個DataTable擁有strSql查詢語句中所包括的字段,但DataTable對象的名稱為默認的Table,而不是查詢語句中所查詢的表的名稱。
使用重載的Fill方法
指定DataTable
da.Fill(DataSet,”MyTableName”)// SqlDataAdapter填充指定DataSet的特定表。
da.Fill(DataTable);// SqlDataAdapter填充已經創建的DataTable對象。
Fill方法分頁顯示
da.Fill(DataSet,intStartRecord,intNumRecord,”TableName”);//Fill方法可能很輕松的實現分頁顯示,但操作效率很低。
調用SqlDataAdapter對象Fill方法過程的數據庫連接的打開與關閉
SqlDataAdapter的Fill方法調用前不需要有活動的SqlConnection對象,SqlDataAdapter會自己打開strConn語句中的數據庫,獲取查詢結果后,關閉與數據庫的連接。如果已經存在SqlConnection對象,無論是否已經打開,SqlDataAdapter執行完Fill方法后,均會將SqlConnection對象返回到原始狀態。
當程序中的多個SqlDataAdapter對象使用都一個SqlConnection對象時,為避免多次打開與關閉SqlConnection對象,應該在調用SqlDataAdapter的Fill方法前調用SqlConnection的Open方法打開數據庫的連接,待完成Fill調用后再調用SqlConnection的Close方法關閉數據庫的連接。
DataSet中數據的更新
如果DataSet中的數據需要更新,在調用Fill方法之前應該先清除DataSet或DataTable中的數據,這樣可以確保DataTable中不會出現重復的數據行,也不會出現數據庫中已經不存在的數據行。
3. 將查詢結果映射到DataSet
TableMappings映射
TabbleMappings集合控制SqlDataAdapter如何將DataSet映射到數據庫。如果保持TabbleMappings集合為空,調用Fill方法,然后將DataSet作為參數,而不指定表名,SqlDataAdapter將假定您希望使用一個名為“Table”的DataTable來裝載數據。
SqlDataAdapter.TableMappings.Add(“Table”,”Employees”)
此語句的作用是將DataSet中原來名字為“Table”的DataTable命名為“Employees”,DataSet填充數據時,按查詢結果集的順序依次填充DataSet中的Table、Table1、Table2……,所以給DataTable命名時需留意該DataTable是否為當前將要使用的對象。
TableMappings和ColumnMappings的AddRange方法
構造并賦值DataTableMapping、DataColumnMapping數組,再調用它們的AddRange方法將該集合整體添加到映射數組。
DataTableMapping tableMap; tableMap=da.TableMapping.Add(“Table”,”Employees”); DataColumnMapping[] columnMaps; columnMaps=new DataColumnMapping[]; {new DataColumnMapping (“EmpID”,”EmployeeID”), new DataColumnMapping (“LName”,”LastName”) } tableMap.ColumnMapping.AddRange(columnMaps);
在TableMappings集合時,它將查看MissingMappingAction屬性的值來決定如何操作。
Passthrough 映射中沒有出現的列仍然填充到DataSet,采用原結果集的名稱;
Ignore 忽略映射中沒有出現的列;
Error 在出現不匹配的情況下引發異常;
文章列表