OdbcDataAdapter 類別

定義

命名空間:

System.Data.Odbc

組件:

System.Data.Odbc.dll

套件:

System.Data.Odbc v11.0.0-preview.2.26159.112

來源:

OdbcDataAdapter.cs

代表一組資料指令及與資料來源的連結，用於填充 DataSet 及更新資料來源。 無法繼承這個類別。

public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

type OdbcDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable

繼承

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OdbcDataAdapter

實作

IDataAdapter IDbDataAdapter ICloneable

範例

以下範例使用 OdbcCommand、 OdbcDataAdapter和 OdbcConnection 來選擇記錄，並將所選列填入 a DataSet 。

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter =
            new OdbcDataAdapter(queryString, connection);

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter(queryString, connection)

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

備註

它 OdbcDataAdapter 作為連接資料 DataSet 來源的橋樑，用於擷取與儲存資料。 透過 OdbcDataAdapter 將 Fill 資料從資料來源載入 DataSet至 ，並透過將 Update 先前所做的 DataSet 變更傳送回資料來源，來提供此橋接。

當 填 OdbcDataAdapter 滿 時 DataSet，會建立所需的資料表和欄位（如果這些資料尚未存在的話）。 然而，除非 MissingSchemaAction 將屬性設為 AddWithKey，否則隱式建立的結構中不會包含主鍵資訊。 你也可以先 OdbcDataAdapter 建立 的結構 DataSet結構，包含主鍵資訊，然後再用 來填充資料 FillSchema。 欲了解更多資訊，請參閱 「將現有約束加入資料集」。

備註

當你在沒有主鍵欄位的資料來源上呼叫該 Fill 方法時，會 OdbcDataAdapter 嘗試將唯一的限制欄位升調到主鍵。 在此過程中，將 OdbcDataAdapter 唯一限制標記為不可空。 除非唯一限制欄位中有空值，否則此行為有效。 若存在空值，則 Fill 該方法因約束違反而失敗。 為避免此情況，唯一限制欄中不應允許 null 值。

備註

由於原生 ODBC 驅動程式的限制，當你撥打 FillSchema時，只會回傳一個DataTable。 即使執行 SQL 批次語句，且預期會有多個 DataTable 物件，這點也同樣適用。

同時 OdbcDataAdapter 也包含 SelectCommand、 InsertCommand、 DeleteCommand、 UpdateCommand及 TableMappings 屬性，以便資料載入與更新。

建構函式

名稱	Description
OdbcDataAdapter()	初始化 OdbcDataAdapter 類別的新執行個體。
OdbcDataAdapter(OdbcCommand)	以指定的 SQL SELECT 陳述式初始化該 OdbcDataAdapter 類別的新實例。
OdbcDataAdapter(String, OdbcConnection)	用 SQL SELECT 陳述句和 OdbcConnection. 來初始化該OdbcDataAdapter類別的新實例。
OdbcDataAdapter(String, String)	以 SQL SELECT 語句和連接字串初始化該 OdbcDataAdapter 類別的新實例。

屬性

名稱	Description
DeleteCommand	取得或設定一個 SQL 陳述式或儲存程序，用於刪除資料來源中的紀錄。
InsertCommand	取得或設定一個 SQL 陳述式或儲存程序，用於將新紀錄插入資料來源。
SelectCommand	取得或設定一個 SQL 陳述式或儲存程序，用於選擇資料來源中的紀錄。
UpdateCommand	取得或設定一個 SQL 陳述式或儲存程序，用於更新資料來源中的記錄。

事件

名稱	Description
RowUpdated	發生在對資料來源執行指令後的更新操作中。
RowUpdating	發生在 Update(DataSet) 對資料來源執行指令之前。

明確介面實作

名稱	Description
ICloneable.Clone()	關於此成員的描述，請參見 Clone()。
IDbDataAdapter.DeleteCommand	關於此成員的描述，請參見 DeleteCommand。
IDbDataAdapter.InsertCommand	關於此成員的描述，請參見 InsertCommand。
IDbDataAdapter.SelectCommand	關於此成員的描述，請參見 SelectCommand。
IDbDataAdapter.UpdateCommand	關於此成員的描述，請參見 UpdateCommand。

另請參閱

• DataAdapter 和 DataReader