OleDbCommandBuilder 类

定义

命名空间:

System.Data.OleDb

程序集:

System.Data.OleDb.dll

包:

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

Source:

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

示例

以下示例使用数据源中的OleDbCommandOleDbDataAdapterOleDbConnection行和行。 此示例传递了已 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单表更新的属性OleDbDataAdapter，则可以创建一个OleDbCommandBuilder对象来自动生成 SQL 语句。 然后，未设置的任何其他 SQL 语句都由该 OleDbCommandBuilder语句生成。

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

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

它还使用由 /&a0> 引用的属性和属性。 如果用户修改了其中一个或多个属性，或者自行替换，SelectCommand则用户应调用RefreshSchema。 否则 InsertCommand， UpdateCommand和 DeleteCommand 属性将保留其以前的值。

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

构造函数

名称	说明
OleDbCommandBuilder()	初始化 OleDbCommandBuilder 类的新实例。
OleDbCommandBuilder(OleDbDataAdapter)	使用关联的OleDbDataAdapter对象初始化类的新实例OleDbCommandBuilder。

属性

名称	说明
DataAdapter	获取或设置 OleDbDataAdapter 自动生成 SQL 语句的对象。

方法

名称	说明
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 生成命令