OleDbCommandBuilder 类

定义

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

public ref class OleDbCommandBuilder sealed : System::ComponentModel::Component

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

public sealed class OleDbCommandBuilder : System.ComponentModel.Component

type OleDbCommandBuilder = class
    inherit DbCommandBuilder

type OleDbCommandBuilder = class
    inherit Component

Public NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilder

Public NotInheritable Class OleDbCommandBuilder
Inherits Component

继承

Object

MarshalByRefObject

Component

DbCommandBuilder

OleDbCommandBuilder

继承

Object

MarshalByRefObject

Component

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不会自动生成协调对 与关联数据源所做的更改DataSet所需的 SQL 语句。 但是，如果设置了 SelectCommand 的 属性，则可以创建对象OleDbCommandBuilder来自动生成单表更新的 OleDbDataAdapterSQL 语句。 然后，未设置的任何其他 SQL 语句都由 OleDbCommandBuilder生成。

每当设置 属性时， DataAdapter 会将OleDbCommandBuilder自身注册为事件的侦听器RowUpdating。 一次只能将一个 OleDbDataAdapter 或 OleDbCommandBuilder 对象相互关联。

若要生成 INSERT、UPDATE 或 DELETE 语句， OleDbCommandBuilder 使用 SelectCommand 属性自动检索所需的元数据集。 如果在检索元数据后（例如在第一次更新之后）更改 SelectCommand ，则应调用 RefreshSchema 方法来更新元数据。

还OleDbCommandBuilder使用 Connection引用的 SelectCommand、 CommandTimeout和 Transaction 属性。 如果修改了其中一个或多个属性，或者SelectCommand替换了自身，则用户应调用 RefreshSchema 。 否则， InsertCommandUpdateCommand和 DeleteCommand 属性将保留其以前的值。

如果调用 Dispose， OleDbCommandBuilder 则会取消与 OleDbDataAdapter的关联，并且不再使用生成的命令。

另请参阅

• 使用 CommandBuilder 生成命令