IDataAdapter 接口

  • 参考

定义

命名空间:
System.Data
程序集:
System.Data.Common.dll
程序集:
System.Data.dll
程序集:
netstandard.dll

允许对象实现 DataAdapter，并且表示一组用于填充和更新 DataSet 及数据源的方法以及与映射操作有关的属性。

IDbDataAdapter 实例针对作为（或类似于）具有文字命令（如 Transact-SQL）的关系数据库的数据源，而 IDataAdapter 实例可使用任何类型的数据源。

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface IDataAdapter
派生

示例

以下示例使用派生类 SqlCommand、 SqlDataAdapter和 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

注解

接口 IDataAdapter 允许继承类实现 DataAdapter 类，该类表示数据源和 DataSet之间的桥。 有关 DataAdapter 类的详细信息，请参阅 从 DataAdapter 填充数据集。

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

继承 IDataAdapter 的类必须实现继承的成员，并且它们通常定义附加的成员以添加特定于提供程序的功能。 例如， IDataAdapter 接口定义采用 Fill 作为参数的方法 DataSet 。 反过来， OleDbDataAdapter 类继承 方法， Fill 还定义了方法的 Fill 两个附加重载，这些重载采用 ADO Recordset 对象作为参数。

实施者说明

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

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

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

属性

MissingMappingAction

指示或指定是否将未映射的源表或列与其源名一起传递以便筛选或引发错误。
MissingSchemaAction

指示或指定是否将丢失的源表、列及其关系添加到数据集架构中，是否忽略它们或者它们是否会引发错误。
TableMappings

获取一个集合，该集合指示如何将源表映射到数据集表。

方法

Fill(DataSet)

添加或更新 DataSet 中的行以匹配使用 DataSet 名称的数据源中的行，并创建一个名为“Table”的 DataTable。
FillSchema(DataSet, SchemaType)

将名为“Table”的 DataTable 添加到指定的 DataSet，并根据指定的 SchemaType 配置架构以匹配数据源中的架构。
GetFillParameters()

获取当执行 SQL SELECT 语句时由用户设置的参数。
Update(DataSet)

从名为“Table”的 DataSet 为指定的 DataTable 中每个已插入、已更新或已删除的行调用相应的 INSERT、UPDATE 或 DELETE 语句。

适用于