IDbDataAdapter 接口

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

程序集:

System.Data.dll

程序集:

netstandard.dll

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

public interface class IDbDataAdapter : System::Data::IDataAdapter

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

派生

System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

实现

IDataAdapter

示例

以下示例使用派生类，SqlCommandSqlDataAdapter以及SqlConnection从数据源中选择记录。 然后返回填充 DataSet 。 为此，该方法将传递一个已DataSet初始化、连接字符串和一个查询字符串，该字符串是 Transact-SQL SELECT 语句。

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;
    }
}

Public Function SelectRows( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

注解

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

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

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

实施者说明

若要在.NET Framework数据提供程序之间提升一致性，请在 DataAdapter 中Prv命名继承类，其中Prv为特定.NET Framework数据提供程序命名空间中的所有类提供统一前缀。 例如，Sql命名空间中System.Data.SqlClient类的SqlDataAdapter前缀。

从 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)