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 构造函数。

示例

---

下面的示例使用 SqlCommand、SqlDataAdapter 和 SqlConnection 从数据库中选择记录，并用选定的行填充 DataSet。然后返回已填充的 DataSet。为完成此任务，向该方法传递一个已初始化的 DataSet、一个连接字符串和一个查询字符串，后者是一个 Transact-SQL SELECT 语句。

C#

复制

private static DataSet SelectRows(DataSet dataset,
    string connectionString,string queryString) 
{
    using (SqlConnection connection = 
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}
 

继承层次结构

---

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DataAdapter
         System.Data.Common.DbDataAdapter
           System.Data.SqlClient.SqlDataAdapter

线程安全

---

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。