DbDataAdapter 類別

定義

命名空間:

System.Data.Common

組件:

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*命令 *selectCommand*)	使用指定的 SQL SELECT 語句，初始化 *Prv*DataAdapter 類別的新實例。
*Prv*DataAdapter (字串串 *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 作業期間，當 DataRow 新增至 DataTable 之後，是否要在其上呼叫 AcceptChanges()。 (繼承來源 DataAdapter)
AcceptChangesDuringUpdate	取得或設定在 AcceptChanges() 期間是否呼叫 Update(DataSet)。 (繼承來源 DataAdapter)
CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承來源 Component)
Container	取得包含 IContainer 的 Component。 (繼承來源 Component)
ContinueUpdateOnError	取得或設定數值，指定當資料列更新期間發生錯誤時，是否產生例外狀況。 (繼承來源 DataAdapter)
DeleteCommand	取得或設定命令，以從資料集刪除資料錄。
DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component)
Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component)
FillCommandBehavior	取得或設定用來填入資料配接器 (Adapter) 之命令的行為。
FillLoadOption	取得或設定 LoadOption，決定配接器如何從 DataTable 填入 DbDataReader。 (繼承來源 DataAdapter)
InsertCommand	取得或設定用來將新的資料錄插入至資料來源的命令。
MissingMappingAction	判斷在傳入的資料不具有相符的資料表或資料行時要採取的動作。 (繼承來源 DataAdapter)
MissingSchemaAction	判斷在現有 DataSet 結構描述 (Schema) 與傳入的資料不相符時要採取的動作。 (繼承來源 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)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	初始化 RowUpdatedEventArgs 類別的新執行個體。
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	初始化 RowUpdatingEventArgs 類別的新執行個體。
CreateTableMappings()	建立新的 DataTableMappingCollection。 (繼承來源 DataAdapter)
Dispose()	釋放 Component 所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	釋放 DbDataAdapter 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。
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)	根據指定的 DataTable，設定指定 SchemaType 的結構描述。
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()	已淘汰. 擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 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 物件是否存在並且應該保存 (Persist)。 (繼承來源 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)	針對具有指定 DataTable 名稱之 DataSet 中的每個插入、更新或刪除的資料列，執行個別的 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 陳述式。

另請參閱

• DbProviderFactory (ADO.NET)
• ADO.NET 概觀 \(部分機器翻譯\)