IDbDataAdapter 接口

定义

命名空间:

System.Data

程序集:

netstandard.dll, System.Data.Common.dll

表示一组与命令有关的属性，用于填充 DataSet 和更新数据源，并由访问关系数据库的 .NET 数据提供程序实现。

C#

public interface IDbDataAdapter : System.Data.IDataAdapter

派生

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

实现

IDataAdapter

示例

以下示例使用派生类 SqlCommand、 SqlDataAdapter 和 SqlConnection从数据源中选择记录。 然后返回填充 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;
    }
}

注解

接口 IDbDataAdapter 继承自 接口， IDataAdapter 并允许对象创建 DataAdapter，设计用于关系数据库。 IDbDataAdapter接口（可选）实用工具类 DbDataAdapter允许继承类实现 DataAdapter 类，该类表示数据源和 DataSet之间的桥。 有关 DataAdapter 类的详细信息，请参阅 从 DataAdapter 填充数据集。 有关实现 .NET Framework 数据提供程序的详细信息，请参阅 实现 .NET Framework 数据提供程序。

应用程序不会直接创建 接口的 IDbDataAdapter 实例，而是创建继承 IDbDataAdapter 和 DbDataAdapter的类的实例。

继承 IDbDataAdapter 的类必须实现继承的成员，并且通常定义其他成员以添加特定于提供程序的功能。 例如， IDbDataAdapter 接口定义 SelectCommand 属性，接口 DbDataAdapter 定义采用 Fill 作为参数的方法 DataTable 。 类进而OleDbDataAdapter继承 属性和 Fill 方法，还定义了方法的Fill两个附加重载，该方法采用 ADO Recordset SelectCommand 对象作为参数。

实施者说明

若要促进 .NET Framework 数据提供程序之间的一致性，请将继承类命名为 DataAdapter 格式 Prv ，其中 Prv 是给定给特定 .NET Framework 数据提供程序命名空间中所有类的统一前缀。 例如， Sql 是 命名空间中 类的SqlDataAdapterSystem.Data.SqlClient前缀。

从 IDbDataAdapter 接口继承时，应实现以下构造函数：

项	描述
PrvDataAdapter ()	初始化 PrvDataAdapter 类的新实例。
PrvDataAdapter (PrvCommand selectCommand)	使用指定的 SQL SELECT 语句初始化 PrvDataAdapter 类的新实例。
PrvDataAdapter (字符串 selectCommandText，字符串 selectConnectionString)	使用 SQL SELECT 语句和连接字符串初始化 PrvDataAdapter 类的新实例。
PrvDataAdapter (字符串 selectCommandText，PrvConnection selectConnection)	使用 SQL SELECT 语句和 PrvConnection 对象初始化 PrvDataAdapter 类的新实例。

属性

DeleteCommand	获取或设置用于从数据集中删除记录的 SQL 语句。
InsertCommand	获取或设置用于将新记录插入到数据源中的 SQL 语句。
MissingMappingAction	指示或指定是否将未映射的源表或列与其源名一起传递以便筛选或引发错误。 (继承自 IDataAdapter)
MissingSchemaAction	指示或指定是否将丢失的源表、列及其关系添加到数据集架构中，是否忽略它们或者它们是否会引发错误。 (继承自 IDataAdapter)
SelectCommand	获取或设置用于在数据源中选择记录的 SQL 语句。
TableMappings	获取一个集合，该集合指示源表如何映射到数据集表。 (继承自 IDataAdapter)
UpdateCommand	获取或设置用于更新数据源中的记录的 SQL 语句。

方法

Fill(DataSet)	添加或更新 DataSet 中的行以匹配使用 DataSet 名称的数据源中的行，并创建一个名为“Table”的 DataTable。 (继承自 IDataAdapter)
FillSchema(DataSet, SchemaType)	将名为“Table”的 DataTable 添加到指定的 DataSet，并根据指定的 SchemaType 配置架构以匹配数据源中的架构。 (继承自 IDataAdapter)
GetFillParameters()	获取当执行 SQL SELECT 语句时由用户设置的参数。 (继承自 IDataAdapter)
Update(DataSet)	从名为“Table”的 DataSet 为指定的 DataTable 中每个已插入、已更新或已删除的行调用相应的 INSERT、UPDATE 或 DELETE 语句。 (继承自 IDataAdapter)

适用于