DbDataAdapter 类

定义

命名空间:

System.Data.Common

程序集:

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

方法

AddToBatch(IDbCommand)	向当前批处理添加 IDbCommand。
ClearBatch()	从批处理中移除所有 IDbCommand 对象。
CloneInternals()	已过时. 创建此 DataAdapter 实例的一个副本。 (继承自 DataAdapter)
CreateObjRef(Type)	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
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)	在 DataSet 中添加或刷新行。
Fill(DataSet, Int32, Int32, String)	在 DataSet 的指定范围中添加或刷新行以匹配使用 DataSet 和 DataTable 名称的数据源中的行。
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	使用 DataSet 和源表名称、命令字符串以及命令行为，在 DataSet 的指定范围中添加或刷新某些行以使它们与数据源中对应的行相一致。
Fill(DataSet, String)	在 DataSet 中添加或刷新行以匹配使用 DataSet 和 DataTable 名称的数据源中的行。
Fill(DataSet, String, IDataReader, Int32, Int32)	在 DataSet 的指定范围中添加或刷新行以匹配使用 DataSet 和 DataTable 名称的数据源中的行。 (继承自 DataAdapter)
Fill(DataTable)	在 DataSet 的指定范围中添加或刷新行，以与使用 DataTable 名称的数据源中的行匹配。
Fill(DataTable, IDataReader)	在 DataTable 中添加或刷新行以与使用 DataTable 名称和指定的 IDataReader 的数据源中的行匹配。 (继承自 DataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	在 DataTable 中添加或刷新行，以与使用指定的 DataTable、IDbCommand 和 CommandBehavior 的数据源中的行匹配。
Fill(DataTable[], IDataReader, Int32, Int32)	在 DataTable 对象集合的指定范围中添加或刷新行以与数据源中的行匹配。 (继承自 DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	在 DataSet 的指定范围中添加或刷新行以匹配使用 DataSet 和 DataTable 名称的数据源中的行。
Fill(Int32, Int32, DataTable[])	添加或刷新一个或多个 DataTable 对象中的行，以匹配数据源中的行，从指定记录开始并检索最多指定的最大记录数。
FillSchema(DataSet, SchemaType)	将名为“Table”的 DataTable 添加到指定的 DataSet，并根据指定的 SchemaType 配置架构以匹配数据源中的架构。
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	将 DataTable 添加到指定的 DataSet ，并根据指定的 SchemaType配置架构以匹配数据源中的架构。
FillSchema(DataSet, SchemaType, String)	将 DataTable 添加到指定的 DataSet 中，并根据指定的 SchemaType 和 DataTable 配置架构以匹配数据源中的架构。
FillSchema(DataSet, SchemaType, String, IDataReader)	向指定的 DataTable 添加一个 DataSet。 (继承自 DataAdapter)
FillSchema(DataTable, SchemaType)	根据指定的 SchemaType 配置指定 DataTable 的架构。
FillSchema(DataTable, SchemaType, IDataReader)	向指定的 DataTable 添加一个 DataSet。 (继承自 DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	根据指定的 DataTable、命令字符串以及 SchemaType 值配置指定 CommandBehavior 的架构。
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)	引发 .NET 数据提供程序的 RowUpdated 事件。
OnRowUpdating(RowUpdatingEventArgs)	引发 .NET 数据提供程序的 RowUpdating 事件。
ResetFillLoadOption()	将 FillLoadOption 重置为默认状态，并使 Fill(DataSet) 接受 AcceptChangesDuringFill。 (继承自 DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	确定是否应保持 AcceptChangesDuringFill 属性。 (继承自 DataAdapter)
ShouldSerializeFillLoadOption()	确定是否应保持 FillLoadOption 属性。 (继承自 DataAdapter)
ShouldSerializeTableMappings()	确定一个或多个 DataTableMapping 对象是否存在，并且它们是否应该是持久的。 (继承自 DataAdapter)
TerminateBatching()	结束 DbDataAdapter 的批处理。
ToString()	返回包含 Component 的名称的 String（如果有）。 不应重写此方法。 (继承自 Component)
Update(DataRow[])	通过为 DataSet 中的指定数组中的每个已插入、已更新或已删除的行执行相应的 INSERT、UPDATE 或 DELETE 语句来更新数据库中的值。
Update(DataRow[], DataTableMapping)	通过为指定的 DataRow 对象数组中的每个已插入、已更新或已删除的行执行相应的 INSERT、UPDATE 或 DELETE 语句来更新数据库中的值。
Update(DataSet)	通过为指定的 DataSet 中的每个已插入、已更新或已删除的行执行相应的 INSERT、UPDATE 或 DELETE 语句来更新数据库中的值。
Update(DataSet, String)	通过为具有指定名称 DataSet 的 DataTable 中的每个已插入、已更新或已删除的行执行相应的 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 概述