DataAdapter 类

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

Source:

DataAdapter.cs

表示用于填充 DataSet 和更新数据源的一组 SQL 命令和一个数据库连接。

public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapter

public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter

type DataAdapter = class
    inherit Component
    interface IDataAdapter

Public Class DataAdapter
Inherits Component
Implements IDataAdapter

继承

Object

MarshalByRefObject

Component

DataAdapter

派生

System.Data.Common.DbDataAdapter

实现

IDataAdapter

注解

用作 DataAdapter 和数据源之间的 DataSet 桥梁，用于检索和保存数据。 DataAdapter通过映射Fill来提供此网桥，映射会更改 中的数据DataSet以匹配数据源中的数据，和 Update，后者更改数据源中的数据以匹配 中的数据DataSet。

如果要连接到SQL Server数据库，则可以使用 SqlDataAdapter 及其关联的 SqlCommand 和 SqlConnection 对象来提高整体性能。 对于 OLE DB 支持的数据源，将 与其关联的 OleDbCommand 和 OleDbConnection 对象一DataAdapter起使用。 对于支持 ODBC 的数据源，请将 与其关联的 OdbcCommand 和 OdbcConnection 对象一DataAdapter起使用。 对于 Oracle 数据库，将 与其关联的 OracleCommand 和 OracleConnection 对象一DataAdapter起使用。

创建 实例 DataAdapter 时，读/写属性设置为初始值。 有关这些值的列表，请参阅 DataAdapter 构造函数。

构造函数

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

属性

AcceptChangesDuringFill	获取或设置一个值，该值指示在任何 Fill 操作过程中，在将 AcceptChanges() 添加到 DataRow 之后是否在 DataTable 上调用它。
AcceptChangesDuringUpdate	获取或设置在 AcceptChanges() 期间是否调用 Update(DataSet)。
CanRaiseEvents	获取一个指示组件是否可以引发事件的值。 (继承自 Component)
Container	获取包含 IContainer 的 Component。 (继承自 Component)
ContinueUpdateOnError	获取或设置一个值，该值指定在行更新过程中遇到错误时是否生成异常。
DesignMode	获取一个值，用以指示 Component 当前是否处于设计模式。 (继承自 Component)
Events	获取附加到此 Component 的事件处理程序的列表。 (继承自 Component)
FillLoadOption	获取或设置 LoadOption，后者确定适配器如何从 DataTable 中填充 DbDataReader。
MissingMappingAction	确定传入数据没有匹配的表或列时需要执行的操作。
MissingSchemaAction	确定现有 DataSet 架构与传入数据不匹配时需要执行的操作。
ReturnProviderSpecificTypes	获取或设置 Fill 方法是应当返回提供程序特定的值，还是返回公用的符合 CLS 的值。
Site	获取或设置 Component 的 ISite。 (继承自 Component)
TableMappings	获取一个集合，该集合提供源表和 DataTable之间的主映射。

方法

CloneInternals()	已过时. 创建此 DataAdapter 实例的一个副本。
CreateObjRef(Type)	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
CreateTableMappings()	创建一个新的 DataTableMappingCollection。
Dispose()	释放由 Component 使用的所有资源。 (继承自 Component)
Dispose(Boolean)	释放由 DataAdapter 占用的非托管资源，还可以另外再释放托管资源。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
Fill(DataSet)	在 DataSet 中添加或刷新行以与数据源中的行匹配。
Fill(DataSet, String, IDataReader, Int32, Int32)	在 DataSet 的指定范围中添加或刷新行以匹配使用 DataSet 和 DataTable 名称的数据源中的行。
Fill(DataTable, IDataReader)	在 DataTable 中添加或刷新行以与使用 DataTable 名称和指定的 IDataReader 的数据源中的行匹配。
Fill(DataTable[], IDataReader, Int32, Int32)	在 DataTable 对象集合的指定范围中添加或刷新行以与数据源中的行匹配。
FillSchema(DataSet, SchemaType)	将 DataTable 添加到指定的 DataSet ，并根据指定的 SchemaType配置架构以匹配数据源中的架构。
FillSchema(DataSet, SchemaType, String, IDataReader)	向指定的 DataTable 添加一个 DataSet。
FillSchema(DataTable, SchemaType, IDataReader)	向指定的 DataTable 添加一个 DataSet。
GetFillParameters()	获取当执行 SQL SELECT 语句时由用户设置的参数。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetLifetimeService()	已过时. 检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetService(Type)	返回一个对象，该对象表示由 Component 或它的 Container 提供的服务。 (继承自 Component)
GetType()	获取当前实例的 Type。 (继承自 Object)
HasTableMappings()	指示是否已创建了一个 DataTableMappingCollection。
InitializeLifetimeService()	已过时. 获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
OnFillError(FillErrorEventArgs)	当 Fill 过程中出现错误时调用。
ResetFillLoadOption()	将 FillLoadOption 重置为默认状态，并使 Fill(DataSet) 接受 AcceptChangesDuringFill。
ShouldSerializeAcceptChangesDuringFill()	确定是否应保持 AcceptChangesDuringFill 属性。
ShouldSerializeFillLoadOption()	确定是否应保持 FillLoadOption 属性。
ShouldSerializeTableMappings()	确定一个或多个 DataTableMapping 对象是否存在，并且它们是否应该是持久的。
ToString()	返回包含 Component 的名称的 String（如果有）。 不应重写此方法。 (继承自 Component)
Update(DataSet)	从名为“Table”的 DataSet 为指定的 DataTable 中每个已插入、已更新或已删除的行调用相应的 INSERT、UPDATE 或 DELETE 语句。

事件

Disposed	在通过调用 Dispose() 方法释放组件时发生。 (继承自 Component)
FillError	在填充操作过程中出现错误时返回。

显式接口实现

IDataAdapter.TableMappings

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

另请参阅

• ADO.NET 概述