DataAdapter 類別

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

來源:

DataAdapter.cs

代表一組 SQL 命令和一個資料庫連接，用來填入 DataSet 並更新資料來源。

C#

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

繼承

Object

MarshalByRefObject

Component

DataAdapter

衍生

System.Data.Common.DbDataAdapter

實作

IDataAdapter

備註

DataAdapter做為 和數據源之間的DataSet網橋，用於擷取和儲存數據。 會 DataAdapter 藉由對應 Fill來提供此網橋，這會變更 DataSet 中的數據，以符合數據源中的數據，而 Update會變更數據源中的數據以符合 DataSet中的數據。

如果您要連線到 SQL Server 資料庫，您可以搭配其相關聯的 SqlCommand 和 SqlConnection 物件使用 SqlDataAdapter 來提升整體效能。 若為 OLE DB 支援的數據源，請使用 DataAdapter 與其相關聯的 OleDbCommand 和 OleDbConnection 物件。 對於 ODBC 支援的數據源，請使用 DataAdapter 與其相關聯的 OdbcCommand 和 OdbcConnection 物件。 針對 Oracle 資料庫，請使用 DataAdapter 與其相關聯的 OracleCommand 和 OracleConnection 物件。

建立 的 DataAdapter 實例時，讀取/寫入屬性會設定為初始值。 如需這些值的清單，請參閱建 DataAdapter 構函式。

建構函式

DataAdapter()	初始化 DataAdapter 類別的新執行個體。
DataAdapter(DataAdapter)	從相同型別的現有物件初始化 類別的新實例 DataAdapter 。

屬性

AcceptChangesDuringFill	取得或設定值，指出在任何一種 Fill 作業期間，當 DataRow 新增至 DataTable 之後，是否要在其上呼叫 AcceptChanges()。
AcceptChangesDuringUpdate	取得或設定在 AcceptChanges() 期間是否呼叫 Update(DataSet)。
CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承來源 Component)
Container	取得包含 IContainer 的 Component。 (繼承來源 Component)
ContinueUpdateOnError	取得或設定數值，指定當資料列更新期間發生錯誤時，是否產生例外狀況。
DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component)
Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component)
FillLoadOption	取得或設定 LoadOption，決定配接器如何從 DataTable 填入 DbDataReader。
MissingMappingAction	判斷在傳入的資料不具有相符的資料表或資料行時要採取的動作。
MissingSchemaAction	判斷在現有 DataSet 結構描述 (Schema) 與傳入的資料不相符時要採取的動作。
ReturnProviderSpecificTypes	取得或設定 Fill 方法應當傳回提供者特定的值，還是通用符合 CLS 標準的值。
Site	取得或設定 Component 的 ISite。 (繼承來源 Component)
TableMappings	取得集合，這個集合提供源數據表與 DataTable之間的主要對應。

方法

CloneInternals()	已淘汰. 建立 DataAdapter 的這個執行個體的複本。
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
CreateTableMappings()	建立新的 DataTableMappingCollection。
Dispose()	釋放 Component 所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	釋放 DataAdapter 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。
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()	已淘汰. 擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 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 物件是否存在並且應該保存 (Persist)。
ToString()	傳回任何包含 Component 名稱的 String。 不應覆寫此方法。 (繼承來源 Component)
Update(DataSet)	從名為 "Table" 之 DataSet 的指定 DataTable 中，為每個插入、更新或刪除的資料列分別呼叫 INSERT、UPDATE 或 DELETE 陳述式。

事件

Disposed	當 Dispose() 方法的呼叫處置元件時，就會發生。 (繼承來源 Component)
FillError	當填入作業期間發生錯誤時傳回。

明確介面實作

IDataAdapter.TableMappings

取得集合，指出源數據表如何對應至數據集數據表。

適用於

另請參閱

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