DbDataAdapter 類別

定義

命名空間:

System.Data.Common

組件:

netstandard.dll, System.Data.Common.dll

來源:

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*）	初始化一個新的 *Prv*DataAdapter 類別實例，並使用指定的 SQL SELECT 語句。
*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的前綴。

建構函式

名稱	Description
DbDataAdapter()	初始化一個新的 DataAdapter 類別實例。
DbDataAdapter(DbDataAdapter)	從同類型的現有物件初始化該 DataAdapter 類別的新實例。

欄位

名稱	Description
DefaultSourceTableName	物件用於資料表映射的預設名稱 DataAdapter 。

屬性

名稱	Description
AcceptChangesDuringFill	在任何填充操作中加入 時DataTable，會取得或設定一個值，AcceptChanges()表示是否在 上被呼叫DataRow。 (繼承來源 DataAdapter)
AcceptChangesDuringUpdate	在 中 被呼叫 時，若 被呼叫Update(DataSet)，則 得到或設定 AcceptChanges() 。 (繼承來源 DataAdapter)
CanRaiseEvents	會得到一個值，表示該元件是否能引發事件。 (繼承來源 Component)
Container	得到 IContainer 包含 Component的 。 (繼承來源 Component)
ContinueUpdateOnError	取得或設定一個值，指定在資料列更新中遇到錯誤時是否要產生例外。 (繼承來源 DataAdapter)
DeleteCommand	取得或設定一個指令，用來從資料集中刪除紀錄。
DesignMode	會得到一個值，表示目前 Component 是否處於設計模式。 (繼承來源 Component)
Events	會取得與此 Component連結的事件處理程序清單。 (繼承來源 Component)
FillCommandBehavior	接收或設定用來填充資料介面卡的指令行為。
FillLoadOption	取得或設定 ，LoadOption決定轉接器如何從 中填充 。DataTableDbDataReader (繼承來源 DataAdapter)
InsertCommand	接收或設定一個指令，用於將新紀錄插入資料來源。
MissingMappingAction	當輸入資料沒有相符的資料表或欄位時，決定應採取的行動。 (繼承來源 DataAdapter)
MissingSchemaAction	當現有 DataSet 結構與輸入資料不符時，決定應採取的行動。 (繼承來源 DataAdapter)
ReturnProviderSpecificTypes	取得或設定方法應 Fill 回傳提供者特定值或常見符合 CLS 的值。 (繼承來源 DataAdapter)
SelectCommand	接收或設定用於選擇資料來源記錄的指令。
Site	取得或設定 ISite 的 Component。 (繼承來源 Component)
TableMappings	取得一個集合，提供來源資料表與 DataTable之間的主要映射。 (繼承來源 DataAdapter)
UpdateBatchSize	取得或設定一個值，啟用或停用批次處理支援，並指定批次中可執行的指令數量。
UpdateCommand	取得或設定用於更新資料來源記錄的指令。

方法

名稱	Description
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)	在指定範圍內 DataSet 新增或刷新資料列，以 DataSet 配合資料來源中的 and DataTable 名稱。
Fill(DataSet, String, IDataReader, Int32, Int32)	在指定範圍內 DataSet 新增或刷新資料列，以 DataSet 配合資料來源中的 and DataTable 名稱。 (繼承來源 DataAdapter)
Fill(DataSet, String)	使用 DataSet 和 DataTable 名稱新增或刷新資料來源中的列，使其與資料來源中的列DataSet相符。
Fill(DataSet)	新增或刷新 DataSet.
Fill(DataTable, IDataReader)	新增或刷新 中 的 DataTable 列，以符合資料來源中的列，使用 DataTable 名稱及指定的 IDataReader。 (繼承來源 DataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	使用 、 DataTableIDbCommandCommandBehavior和 ，新增或刷新 a DataTable 中的列以匹配資料來源中的列。
Fill(DataTable)	在指定範圍內 DataSet 新增或刷新資料列，以符合資料來源中使用 DataTable 名稱的列。
Fill(DataTable[], IDataReader, Int32, Int32)	在物件集合 DataTable 中新增或刷新指定範圍內的列，以匹配資料來源中的列。 (繼承來源 DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	在指定範圍內 DataSet 新增或刷新資料列，以 DataSet 配合資料來源中的 and DataTable 名稱。
Fill(Int32, Int32, DataTable[])	從指定記錄開始，從指定紀錄開始，新增或刷新一個或多個 DataTable 物件的列，以匹配資料來源中的列，並取得最多最多記錄數。
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	在指定DataSet值中加入 aDataTable，並根據指定 SchemaType配置結構以符合資料來源的結構。
FillSchema(DataSet, SchemaType, String, IDataReader)	將 a DataTable 加入指定的 DataSet。 (繼承來源 DataAdapter)
FillSchema(DataSet, SchemaType, String)	將 a DataTable 加入指定的 DataSet 資料，並根據指定的 SchemaType 和 DataTable配置結構以符合資料來源中的結構。
FillSchema(DataSet, SchemaType)	在指定的DataSet資料中新增一個DataTable命名的「資料表」，並根據指定的SchemaType資料配置結構以符合資料來源中的結構。
FillSchema(DataTable, SchemaType, IDataReader)	將 a DataTable 加入指定的 DataSet。 (繼承來源 DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	根據指定的 SchemaType、 指令字串及CommandBehavior值配置 的結構DataTable。
FillSchema(DataTable, SchemaType)	根據指定的 SchemaType配置 的結構DataTable。
GetBatchedParameter(Int32, Int32)	從目前批次中的指令回傳 a IDataParameter 。
GetBatchedRecordsAffected(Int32, Int32, Exception)	回傳一次更新嘗試的資訊，包含較大的批次更新。
GetFillParameters()	執行 SQL SELECT 語句時，取得使用者設定的參數。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 取得目前控制此實例生命週期政策的終身服務物件。 (繼承來源 MarshalByRefObject)
GetService(Type)	回傳一個由 或Component其 所提供的Container服務的物件。 (繼承來源 Component)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
HasTableMappings()	表示是否已創造 a 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 語句，更新資料庫中的值。

事件

名稱	Description
Disposed	當元件被呼叫方法 Dispose() 時會發生。 (繼承來源 Component)
FillError	當填充操作發生錯誤時，會回傳此訊息。 (繼承來源 DataAdapter)

明確介面實作

名稱	Description
ICloneable.Clone()	建立一個新的物件，該物件是目前實例的複製品。
IDataAdapter.TableMappings	取得一個集合，指示來源資料表如何映射到資料集資料表。 (繼承來源 DataAdapter)
IDbDataAdapter.DeleteCommand	取得或設定一個 SQL 陳述式來刪除資料集中的紀錄。
IDbDataAdapter.InsertCommand	取得或設定一個 SQL 陳述式，用於將新紀錄插入資料來源。
IDbDataAdapter.SelectCommand	取得或設定一個用於選擇資料來源記錄的 SQL 陳述式。
IDbDataAdapter.UpdateCommand	取得或設定一個用於更新資料來源記錄的 SQL 語句。

另請參閱

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