SqlDataAdapter

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);         2. 获取查询中的结果         使用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，而不是查询语句中所查询的表的名称。         使用重载的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);         MissingMappingAction属性         当SqlDataAdapter提取查询结果来填充DataSet时，它将检查TableMappings集合，如果存在结果集中列不在TableMappings集合时，它将查看MissingMappingAction属性的值来决定如何操作。         Passthrough 映射中没有出现的列仍然填充到DataSet，采用原结果集的名称；         Ignore 忽略映射中没有出现的列；         Error 在出现不匹配的情况下引发异常；