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和SqlDataAdapterSqlConnection从数据库中选择记录。 然后返回填充 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 类，该类表示数据源与 a DataSet之间的桥接。 有关 DataAdapter 类的详细信息，请参阅 从 DataAdapter 填充数据集。

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

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

实施者说明

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

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

项 描述
PrvDataAdapter () 初始化 PrvDataAdapter 类的新实例。
PrvDataAdapter (PrvCommand selectCommand) 使用指定的 SQL SELECT 语句初始化 PrvDataAdapter 类的新实例。
PrvDataAdapter (字符串 selectCommandText，字符串 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 语句。

适用于