使用SqlDataAdapter對象擷取資料

一．             SqlDataAdapter對象

1. SqlDataAdapter特性

l           SqlDataAdapter類用作ADO.NET對象模型中和資料連接配接部分和未連接配接部分之間的橋梁。SqlDataAdapter從資料庫中擷取資料，并将其存儲在DataSet中。SqlDataAdapter也可能取得DataSet中的更新，并将它們送出給資料庫。

l             SqlDataAdapter是為處理脫機資料而設計的，調用其Fill方法填充DataSet時甚至不需要與資料庫的活動連接配接。即如果調用Fill方法時，SqlDataAdapter與資料庫的連接配接不是打開時，SqlDataAdapter将打開資料庫連接配接，查詢資料庫，提取查詢結果，将查詢結果填入DataSet，然後關閉也資料庫的連接配接。

2. SqlDataAdapter的設定

l            SqlCommand屬性

SqlDataAdapter将查詢結果存儲到DataSet中時，SqlDataAdapter使用SqlCommand和SqlConnection與資料庫進行通信。SqlDataAdapter在内部使用SqlDataReader擷取結果，并将資訊存儲到DataSet的新行。SqlCommand類的屬性包括SelectCommand、InsertCommand、UpdateCommand、DeleteCommand分别對應資料庫的查詢、插入、更新和删除操作。

l         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

l         New 關鍵字

New 關鍵字建立新的SqlDataAdapter對象後，再設定其SqlCommand屬性

       SqlDataAdapter  da＝new  SqlDataAdapter();

       da.SelectCommand=cmd;

l         SqlDataAdapter的構造函數

strSql是查詢數符串；strConn是資料庫連接配接字元串；cmd是SqlCommand對象；cn是SqlConnection對象。

         SqlDataAdapter  da＝new  SqlDataAdapter(strSql,strConn);

         SqlDataAdapter  da＝new  SqlDataAdapter(strSql,cn);

         SqlDataAdapter  da＝new  SqlDataAdapter(cmd);

2. 擷取查詢中的結果

l         使用Fill方法

調用SqlDataAdapter類的Fill方法會執行存儲在SqlDataAdapter對象的SqlCommand屬性中的查詢，并将查詢結果存儲在DataSet中。示例代碼如下：

SqlDataAdapter  da＝new  SqlDataAdapter(strSql,strConn);

DataSet ds ＝new DataSet();

da.Fill(ds);

執行以上代碼後，DataSet的執行個體對象ds中會建立一個新的DataTable，這個DataTable擁有strSql查詢語句中所包括的字段，但DataTable對象的名稱為預設的Table，而不是查詢語句中所查詢的表的名稱。

l         使用重載的Fill方法

         指定DataTable

da.Fill(DataSet,”MyTableName”)// SqlDataAdapter填充指定DataSet的特定表。

da.Fill(DataTable);// SqlDataAdapter填充已經建立的DataTable對象。

         Fill方法分頁顯示

da.Fill(DataSet,intStartRecord,intNumRecord,”TableName”);//Fill方法可能很輕松的實作分頁顯示，但操作效率很低。

l             調用SqlDataAdapter對象Fill方法過程的資料庫連接配接的打開與關閉

SqlDataAdapter的Fill方法調用前不需要有活動的SqlConnection對象，SqlDataAdapter會自己打開strConn語句中的資料庫，擷取查詢結果後，關閉與資料庫的連接配接。如果已經存在SqlConnection對象，無論是否已經打開，SqlDataAdapter執行完Fill方法後，均會将SqlConnection對象傳回到原始狀态。

當程式中的多個SqlDataAdapter對象使用都一個SqlConnection對象時，為避免多次打開與關閉SqlConnection對象，應該在調用SqlDataAdapter的Fill方法前調用SqlConnection的Open方法打開資料庫的連接配接，待完成Fill調用後再調用SqlConnection的Close方法關閉資料庫的連接配接。

l           DataSet中資料的更新

如果DataSet中的資料需要更新，在調用Fill方法之前應該先清除DataSet或DataTable中的資料，這樣可以確定DataTable中不會出現重複的資料行，也不會出現資料庫中已經不存在的資料行。

3. 将查詢結果映射到DataSet

l           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是否為目前将要使用的對象。

l   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);

l       MissingMappingAction屬性

當SqlDataAdapter提取查詢結果來填充DataSet時，它将檢查TableMappings集合，如果存在結果集中列不在TableMappings集合時，它将檢視MissingMappingAction屬性的值來決定如何操作。

         Passthrough 映射中沒有出現的列仍然填充到DataSet，采用原結果集的名稱；

         Ignore  忽略映射中沒有出現的列；

         Error 在出現不比對的情況下引發異常；