DataAdapter 类

定义

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

public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapter
public ref class DataAdapter abstract : System::ComponentModel::Component, System::Data::IDataAdapter
public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
public abstract class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
type DataAdapter = class
    inherit Component
    interface IDataAdapter
Public Class DataAdapter
Inherits Component
Implements IDataAdapter
Public MustInherit Class DataAdapter
Inherits Component
Implements IDataAdapter
继承
派生
实现

注解

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

如果要连接到SQL Server数据库,则可以使用 SqlDataAdapter 及其关联的 SqlCommandSqlConnection 对象来提高整体性能。 对于 OLE DB 支持的数据源,将 与其关联的 OleDbCommandOleDbConnection 对象一DataAdapter起使用。 对于支持 ODBC 的数据源,请将 与其关联的 OdbcCommandOdbcConnection 对象一DataAdapter起使用。 对于 Oracle 数据库,请使用 DataAdapter 与其关联的 OracleCommandOracleConnection 对象。

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

构造函数

DataAdapter()

初始化 DataAdapter 类的新实例。

DataAdapter(DataAdapter)

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

属性

AcceptChangesDuringFill

获取或设置一个值,该值指示在任何 Fill 操作过程中,在将 AcceptChanges() 添加到 DataRow 之后是否在 DataTable 上调用它。

AcceptChangesDuringUpdate

获取或设置在 AcceptChanges() 期间是否调用 Update(DataSet)

CanRaiseEvents

获取一个指示组件是否可以引发事件的值。

(继承自 Component)
Container

获取包含 IContainerComponent

(继承自 Component)
ContinueUpdateOnError

获取或设置一个值,该值指定在行更新过程中遇到错误时是否生成异常。

DesignMode

获取一个值,用以指示 Component 当前是否处于设计模式。

(继承自 Component)
Events

获取附加到此 Component 的事件处理程序的列表。

(继承自 Component)
FillLoadOption

获取或设置 LoadOption,后者确定适配器如何从 DataTable 中填充 DbDataReader

MissingMappingAction

确定传入数据没有匹配的表或列时需要执行的操作。

MissingSchemaAction

确定现有 DataSet 架构与传入数据不匹配时需要执行的操作。

ReturnProviderSpecificTypes

获取或设置 Fill 方法是应当返回提供程序特定的值,还是返回公用的符合 CLS 的值。

Site

获取或设置 ComponentISite

(继承自 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 的指定范围中添加或刷新行以匹配使用 DataSetDataTable 名称的数据源中的行。

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

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

适用于

另请参阅