OleDbCommandBuilder 類別

定義

命名空間:

System.Data.OleDb

組件:

System.Data.OleDb.dll

套件:

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

來源:

OleDbCommandBuilder.cs

自動產生單表指令，用於將對 的 DataSet 變更與相關資料庫進行對比。 無法繼承這個類別。

public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilder

public sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilder

type OleDbCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilder

繼承

Object

MarshalByRefObject

Component

DbCommandBuilder

OleDbCommandBuilder

範例

以下範例使用 OleDbCommand沿 OleDbDataAdapterOleDbConnection、 和 的參數從資料來源中選取列。 範例傳遞了一個初始化的 DataSet、一個連接字串、一個查詢字串（SQL SELECT 語句）以及一個字串（資料來源資料表的名稱）。 此範例會產生一個 OleDbCommandBuilder。

public static DataSet UpdateRows(string connectionString,
    string queryString, string tableName)
{
    DataSet dataSet = new DataSet();
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString, connection);
        OleDbCommandBuilder cb = new OleDbCommandBuilder(adapter);

        connection.Open();

        adapter.Fill(dataSet, tableName);

        //code to modify data in DataSet here

        cb.GetDeleteCommand();
        //Without the OleDbCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);

        connection.Close();
    }
    return dataSet;
}

Public Shared Function UpdateRows(ByVal connectionString As String, _
ByVal queryString As String, ByVal tableName As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString, connection)
        Dim builder As New OleDbCommandBuilder(adapter)

        connection.Open()

        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

        builder.GetUpdateCommand()

        ' Without the OleDbCommandBuilder this line would fail.
        adapter.Update(dataSet, tableName)
    End Using

    Return dataSet
End Function

備註

它 OleDbDataAdapter 不會自動產生 SQL 陳述式，以將對 a DataSet 的變更與相關資料來源進行調和。 不過，如果你設定 SelectCommand 的屬性OleDbDataAdapter，可以建立OleDbCommandBuilder物件，自動產生單資料表更新的 SQL 語句。 然後，任何你未設定的額外 SQL 語句會由 OleDbCommandBuilder產生。

當你設定DataAdapter屬性時，它OleDbCommandBuilder會自動註冊為事件的監聽者RowUpdating。 你一次只能將其中一個 OleDbDataAdapter 或 OleDbCommandBuilder 物件彼此關聯起來。

為了產生 INSERT、UPDATE 或 DELETE 語句，會 OleDbCommandBuilder 使用 該 SelectCommand 屬性自動取得所需的元資料集合。 如果你在元資料取得後才更改， SelectCommand 例如第一次更新後，你應該呼叫 RefreshSchema 更新元資料的方法。

也 OleDbCommandBuilder 使用 Connection了 、 CommandTimeout以及 Transaction 所 SelectCommand參考的屬性。 如果這些屬性中有一個或多個被修改，或SelectCommand是本身被替換，使用者應該呼叫RefreshSchema。 否則 InsertCommand、 UpdateCommand、 和 DeleteCommand 屬性將保留先前的值。

如果你呼叫 Dispose，則 OleDbCommandBuilder 與 分離 OleDbDataAdapter，產生的指令不再使用。

建構函式

名稱	Description
OleDbCommandBuilder()	初始化 OleDbCommandBuilder 類別的新執行個體。
OleDbCommandBuilder(OleDbDataAdapter)	初始化一個帶有相關OleDbDataAdapter物件的新類別實例OleDbCommandBuilder。

屬性

名稱	Description
DataAdapter	取得或設定一個 OleDbDataAdapter 物件，該物件會自動產生 SQL 語句。

方法

名稱	Description
DeriveParameters(OleDbCommand)	從指定於 的 OleDbCommand 儲存程序中取得參數資訊，並填充 Parameters 指定 OleDbCommand 物件的集合。
GetDeleteCommand()	取得自動產生 OleDbCommand 的物件，用於在資料來源執行刪除。
GetDeleteCommand(Boolean)	取得自動產生 OleDbCommand 的物件，用於在資料來源執行刪除。
GetInsertCommand()	取得自動產生 OleDbCommand 的物件，用於在資料來源執行插入。
GetInsertCommand(Boolean)	取得自動產生 OleDbCommand 的物件，用於在資料來源執行插入。
GetUpdateCommand()	取得自動產生 OleDbCommand 的物件，以便在資料來源執行更新。
GetUpdateCommand(Boolean)	取得自動產生 OleDbCommand 的物件，用於在資料來源執行更新，並可選擇使用欄位作為參數名稱。
QuoteIdentifier(String, OleDbConnection)	給定正確目錄中未引號的識別碼，回傳該識別碼的正確引號形式。 這包括正確跳脫識別碼中嵌入的引號。
QuoteIdentifier(String)	給定正確目錄中未引號的識別碼，回傳該識別碼的正確引號形式。 這包括正確跳脫識別碼中嵌入的引號。
UnquoteIdentifier(String, OleDbConnection)	給定引號識別碼， 回傳該識別碼的正確無引號形式。 這包括正確地解除識別碼中嵌入的引號。
UnquoteIdentifier(String)	給定引號識別碼， 回傳該識別碼的正確無引號形式。 這包括正確地解除識別碼中嵌入的引號。

另請參閱

• 使用 CommandBuilders 產生命令