DbDataAdapter 类

定义

命名空间:

System.Data.Common

程序集:

netstandard.dll, System.Data.Common.dll

Source:

DbDataAdapter.cs

帮助实现 IDbDataAdapter 接口。 实现一组函数的 DbDataAdapter 继承器以提供强类型化，但继承了完全实现 DataAdapter 所需的大部分功能。

public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapter

public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter

type DbDataAdapter = class
    inherit DataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter

继承

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

派生

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

实现

IDataAdapter IDbDataAdapter ICloneable

注解

该 DbDataAdapter 类继承自 DataAdapter 该类并实现 IDbDataAdapter 接口。 它帮助类实现用于关系数据库的 DataAdapter 。

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

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

实施者说明

从 DbDataAdapter 类继承时，建议实现以下构造函数：

项	说明
*Prv*DataAdapter（）	初始化 *Prv*DataAdapter 类的新实例。
*Prv*DataAdapter（*Prv*Command *selectCommand*）	使用指定的 SQL SELECT 语句初始化 *Prv*DataAdapter 类的新实例。
*Prv*DataAdapter（string *selectCommandText*， string *selectConnectionString*）	使用 SQL SELECT 语句和连接字符串初始化 *Prv*DataAdapter 类的新实例。
*Prv*DataAdapter（string *selectCommandText*， *Prv*Connection *selectConnection*）	使用 SQL SELECT 语句和 *Prv*Connection 对象初始化 *Prv*DataAdapter 类的新实例。

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

构造函数

名称	说明
DbDataAdapter()	初始化 DataAdapter 类的新实例。
DbDataAdapter(DbDataAdapter)	从同一类型的现有对象初始化类的新实例 DataAdapter 。

字段

名称	说明
DefaultSourceTableName	对象用于 DataAdapter 表映射的默认名称。

属性

名称	说明
AcceptChangesDuringFill	获取或设置一个值，该值指示在将它添加到DataTable任何填充操作期间之后是否AcceptChanges()对它调用DataRow。 (继承自 DataAdapter)
AcceptChangesDuringUpdate	获取或设置是否 AcceptChanges() 在一个 Update(DataSet)过程中调用 。 (继承自 DataAdapter)
CanRaiseEvents	获取一个值，该值指示组件是否可以引发事件。 (继承自 Component)
Container	IContainer获取包含 .Component (继承自 Component)
ContinueUpdateOnError	获取或设置一个值，该值指定在行更新期间遇到错误时是否生成异常。 (继承自 DataAdapter)
DeleteCommand	获取或设置用于从数据集中删除记录的命令。
DesignMode	获取一个值，该值指示当前是否 Component 处于设计模式。 (继承自 Component)
Events	获取附加到此 Component对象的事件处理程序的列表。 (继承自 Component)
FillCommandBehavior	获取或设置用于填充数据适配器的命令的行为。
FillLoadOption	获取或设置LoadOption确定适配器如何从中DbDataReader填充 DataTable 。 (继承自 DataAdapter)
InsertCommand	获取或设置用于将新记录插入数据源的命令。
MissingMappingAction	确定传入数据没有匹配表或列时要执行的操作。 (继承自 DataAdapter)
MissingSchemaAction	确定现有 DataSet 架构与传入数据不匹配时要执行的操作。 (继承自 DataAdapter)
ReturnProviderSpecificTypes	获取或设置该方法应 Fill 返回提供程序特定的值还是符合 CLS 的常见值。 (继承自 DataAdapter)
SelectCommand	获取或设置用于选择数据源中的记录的命令。
Site	获取或设置 ISite .Component (继承自 Component)
TableMappings	获取一个集合，该集合提供源表和 a DataTable. (继承自 DataAdapter)
UpdateBatchSize	获取或设置一个值，该值启用或禁用批处理支持，并指定可在批处理中执行的命令数。
UpdateCommand	获取或设置用于更新数据源中的记录的命令。

方法

名称	说明
AddToBatch(IDbCommand)	将 a IDbCommand 添加到当前批。
ClearBatch()	从批处理中删除所有 IDbCommand 对象。
CloneInternals()	已过时. 创建此实例 DataAdapter的副本。 (继承自 DataAdapter)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	初始化 RowUpdatedEventArgs 类的新实例。
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	初始化 RowUpdatingEventArgs 类的新实例。
CreateTableMappings()	创建新的 DataTableMappingCollection。 (继承自 DataAdapter)
Dispose()	释放该 Component命令使用的所有资源。 (继承自 Component)
Dispose(Boolean)	释放由托管资源使用 DbDataAdapter 的非托管资源，并选择性地释放托管资源。
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
ExecuteBatch()	执行当前批处理。
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	使用DataSet源表名称、命令字符串和命令行为添加或刷新指定区域中DataSet的行，以匹配数据源中的行。
Fill(DataSet, Int32, Int32, String)	使用和DataTable名称添加或刷新指定区域中DataSet的行以匹配数据源DataSet中的行。
Fill(DataSet, String, IDataReader, Int32, Int32)	使用和DataTable名称添加或刷新指定区域中DataSet的行以匹配数据源DataSet中的行。 (继承自 DataAdapter)
Fill(DataSet, String)	使用和DataTable名称在数据源DataSet中添加DataSet或刷新行以匹配这些行。
Fill(DataSet)	在 . 中添加 DataSet或刷新行。
Fill(DataTable, IDataReader)	使用名称和指定IDataReader名称添加或刷新数据源DataTable中的DataTable行以匹配这些行。 (继承自 DataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	使用指定的DataTableIDbCommandCommandBehavior行在数据源中添加DataTable或刷新行，以匹配数据源中的行。
Fill(DataTable)	使用名称添加或刷新指定区域中 DataSet 的行以匹配数据源 DataTable 中的行。
Fill(DataTable[], IDataReader, Int32, Int32)	在对象集合 DataTable 的指定范围内添加或刷新行，以匹配数据源中的行。 (继承自 DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	使用和DataTable名称添加或刷新指定区域中DataSet的行以匹配数据源DataSet中的行。
Fill(Int32, Int32, DataTable[])	在一个或多个 DataTable 对象中添加或刷新行，以匹配从指定记录开始的数据源中的行，并检索到指定的最大记录数。
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	将 a DataTable 添加到指定 DataSet 并配置架构，使其与数据源中基于指定的 SchemaType架构匹配。
FillSchema(DataSet, SchemaType, String, IDataReader)	将 a DataTable 添加到指定的 DataSet。 (继承自 DataAdapter)
FillSchema(DataSet, SchemaType, String)	将 a DataTable 添加到指定 DataSet 并配置架构以匹配数据源中基于指定的 SchemaType 和 DataTable。
FillSchema(DataSet, SchemaType)	DataTable将名为“Table”的指定添加到指定DataSet，并将架构配置为根据指定的SchemaType数据源中的架构匹配。
FillSchema(DataTable, SchemaType, IDataReader)	将 a DataTable 添加到指定的 DataSet。 (继承自 DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	根据指定的命令字符串和CommandBehavior值配置指定的DataTableSchemaType架构。
FillSchema(DataTable, SchemaType)	根据指定的设置配置指定的DataTableSchemaType架构。
GetBatchedParameter(Int32, Int32)	从 IDataParameter 当前批处理中的其中一个命令返回。
GetBatchedRecordsAffected(Int32, Int32, Exception)	返回有关较大批处理更新中单个更新尝试的信息。
GetFillParameters()	获取执行 SQL SELECT 语句时用户设置的参数。
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetLifetimeService()	已过时. 检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetService(Type)	返回一个对象，该对象表示服务由 Component 或其 Container提供的服务。 (继承自 Component)
GetType()	获取当前实例的 Type。 (继承自 Object)
HasTableMappings()	指示是否已创建一个 DataTableMappingCollection 。 (继承自 DataAdapter)
InitializeBatching()	初始化对 .. 的 DbDataAdapter批处理。
InitializeLifetimeService()	已过时. 获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
OnFillError(FillErrorEventArgs)	在发生错误 Fill时调用 。 (继承自 DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	RowUpdated引发 .NET 数据提供程序的事件。
OnRowUpdating(RowUpdatingEventArgs)	RowUpdating引发 .NET 数据提供程序的事件。
ResetFillLoadOption()	FillLoadOption重置为其默认状态并导致Fill(DataSet)遵循AcceptChangesDuringFill。 (继承自 DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	确定是否应保留该 AcceptChangesDuringFill 属性。 (继承自 DataAdapter)
ShouldSerializeFillLoadOption()	确定是否应保留该 FillLoadOption 属性。 (继承自 DataAdapter)
ShouldSerializeTableMappings()	确定是否存在一个或多个 DataTableMapping 对象，并应保留它们。 (继承自 DataAdapter)
TerminateBatching()	结束对 .. 的 DbDataAdapter批处理。
ToString()	返回包含 String 的名称 Component（如果有）。 不应重写此方法。 (继承自 Component)
Update(DataRow[], DataTableMapping)	通过对指定对象数组 DataRow 中每个插入、更新或删除的行执行相应的 INSERT、UPDATE 或 DELETE 语句来更新数据库中的值。
Update(DataRow[])	通过对指定数组 DataSet中每个插入、更新或删除的行执行相应的 INSERT、UPDATE 或 DELETE 语句来更新数据库中的值。
Update(DataSet, String)	通过对具有指定DataTable名称的每个插入、更新或删除行DataSet执行相应的 INSERT、UPDATE 或 DELETE 语句来更新数据库中的值。
Update(DataSet)	通过对指定 DataSet行中的每个插入、更新或删除行执行相应的 INSERT、UPDATE 或 DELETE 语句来更新数据库中的值。
Update(DataTable)	通过对指定 DataTable行中的每个插入、更新或删除行执行相应的 INSERT、UPDATE 或 DELETE 语句来更新数据库中的值。

活动

名称	说明
Disposed	当组件通过对方法的调用 Dispose() 释放时发生。 (继承自 Component)
FillError	在填充操作期间发生错误时返回。 (继承自 DataAdapter)

显式接口实现

名称	说明
ICloneable.Clone()	创建一个新对象，该对象是当前实例的副本。
IDataAdapter.TableMappings	获取一个集合，该集合指示如何将源表映射到数据集表。 (继承自 DataAdapter)
IDbDataAdapter.DeleteCommand	获取或设置用于从数据集中删除记录的 SQL 语句。
IDbDataAdapter.InsertCommand	获取或设置用于将新记录插入数据源的 SQL 语句。
IDbDataAdapter.SelectCommand	获取或设置用于选择数据源中的记录的 SQL 语句。
IDbDataAdapter.UpdateCommand	获取或设置用于更新数据源中的记录的 SQL 语句。

另请参阅

• DbProviderFactories （ADO.NET）
• ADO.NET 概述