DataAdapter 类

定义

命名空间:

System.Data.Common

程序集:

System.Data.dll

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

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 支持的数据源，请使用 DataAdapter 其关联的 OleDbCommand 数据源和 OleDbConnection 对象。 对于 ODBC 支持的数据源，请使用 DataAdapter 其关联的 OdbcCommand 数据源和 OdbcConnection 对象。 对于 Oracle 数据库，请使用 DataAdapter 其关联的 OracleCommand 对象和 OracleConnection 对象。

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

构造函数

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

属性

名称	说明
AcceptChangesDuringFill	获取或设置一个值，该值指示在将它添加到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	获取或设置 ISite 的 Component。 (继承自 Component)
TableMappings	获取一个集合，该集合提供源表和 a DataTable.

方法

名称	说明
CloneInternals()	已过时. 创建此实例 DataAdapter的副本。
CreateObjRef(Type)	创建一个对象，其中包含生成用于与远程对象通信的代理所需的所有相关信息。 (继承自 MarshalByRefObject)
CreateTableMappings()	创建新的 DataTableMappingCollection。
Dispose()	释放该 Component命令使用的所有资源。 (继承自 Component)
Dispose(Boolean)	释放由托管资源使用 DataAdapter 的非托管资源，并选择性地释放托管资源。
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
Fill(DataSet, String, IDataReader, Int32, Int32)	使用和DataSet名称添加或刷新指定区域中DataSet的行以匹配数据源DataTable中的行。
Fill(DataSet)	在数据源中添加或刷新行 DataSet 以匹配这些行。
Fill(DataTable, IDataReader)	使用名称和指定DataTable名称添加或刷新数据源DataTable中的IDataReader行以匹配这些行。
Fill(DataTable[], IDataReader, Int32, Int32)	在对象集合 DataTable 的指定范围内添加或刷新行，以匹配数据源中的行。
FillSchema(DataSet, SchemaType, String, IDataReader)	将 a DataTable 添加到指定的 DataSet。
FillSchema(DataSet, SchemaType)	将 a DataTable 添加到指定 DataSet 并配置架构，使其与数据源中基于指定的 SchemaType架构匹配。
FillSchema(DataTable, SchemaType, IDataReader)	将 a 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()	返回包含 String 的名称 Component（如果有）。 不应重写此方法。 (继承自 Component)
Update(DataSet)	为指定行中的每个插入、更新或删除行调用相应的 INSERT、UPDATE 或 DELETE 语句，该语句从DataSet名为“Table”指定的DataTable行。

活动

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

显式接口实现

名称	说明
IDataAdapter.TableMappings	获取一个集合，该集合指示如何将源表映射到数据集表。

另请参阅

• ADO.NET 概述