DataAdapter 類別

定義

命名空間:: System.Data.Common

組件:: System.Data.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

代表一組 SQL 指令及資料庫連線，用於填充 DataSet 及更新資料來源。

public ref class DataAdapter abstract : System::ComponentModel::Component, System::Data::IDataAdapter

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

public abstract 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 MustInherit Class DataAdapter
Inherits Component
Implements IDataAdapter

Public Class DataAdapter
Inherits Component
Implements IDataAdapter

繼承: Object

MarshalByRefObject

Component
DataAdapter

衍生: System.Data.Common.DbDataAdapter

實作: IDataAdapter

備註

它 DataAdapter 作為連接 A 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 。

建構函式

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

屬性

名稱	Description
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	取得一個集合，提供來源資料表與 DataTable之間的主要映射。

方法

名稱	Description
CloneInternals()	已淘汰. 已淘汰. 已淘汰. 會建立這個實例 DataAdapter的副本。
CreateObjRef(Type)	建立一個物件，包含產生代理伺服器所需的所有相關資訊，用於與遠端物件通訊。 (繼承來源 MarshalByRefObject)
CreateTableMappings()	會產生一個新的 DataTableMappingCollection。
Dispose()	釋放所有由 Component. (繼承來源 Component)
Dispose(Boolean)	釋放未管理的資源， DataAdapter 並可選擇性地釋放受管理資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Fill(DataSet, String, IDataReader, Int32, Int32)	在指定範圍內 DataSet 新增或刷新資料列，以 DataSet 配合資料來源中的 and 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)	在指定DataTable值中加入 aDataSet，並根據指定 SchemaType配置結構以符合資料來源的結構。
FillSchema(DataTable, SchemaType, IDataReader)	將 a DataTable 加入指定的 DataSet。
GetFillParameters()	執行 SQL SELECT 語句時，取得使用者設定的參數。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	取得目前控制此實例生命週期政策的終身服務物件。 (繼承來源 MarshalByRefObject)
GetService(Type)	回傳一個由或Component其所提供的Container服務的物件。 (繼承來源 Component)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
HasTableMappings()	表示是否已創造 a 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)	從一個命名的「資料表」呼叫指定中每個插入、更新或刪除的列DataSet DataTable的相應 INSERT、UPDATE 或 DELETE 語句。

事件

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

明確介面實作

名稱	Description
IDataAdapter.TableMappings	取得一個集合，指示來源資料表如何映射到資料集資料表。

適用於

另請參閱

ADO.NET 概觀

意見反應

此頁面對您有幫助嗎？