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

Примеры

В следующем примере используются 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 SQL, необходимые для согласования изменений, внесенных DataSet в связанный источник данных, не создаются автоматически. Однако можно создать объект для автоматического создания инструкций OleDbCommandBuilder SQL для одно табличных обновлений, если задать SelectCommand свойство объекта OleDbDataAdapter. Затем все дополнительные инструкции SQL, которые не заданы, создаются этим параметром OleDbCommandBuilder.

Регистрирует OleDbCommandBuilder себя в качестве прослушивателя событий RowUpdating всякий раз, когда вы задаете DataAdapter свойство. Вы можете связать только один OleDbDataAdapter или OleDbCommandBuilder объект друг с другом одновременно.

Чтобы создать инструкции INSERT, UPDATE или DELETE, OleDbCommandBuilder свойство используется SelectCommand для автоматического получения требуемого набора метаданных. Если вы измените SelectCommand значение после получения метаданных, например после первого обновления, необходимо вызвать RefreshSchema метод для обновления метаданных.

Кроме того TransactionConnectionCommandTimeout, OleDbCommandBuilder используется и свойства, на которые ссылается ссылка.SelectCommand Пользователь должен вызвать RefreshSchema , если изменено одно или несколько этих свойств или SelectCommand если само свойство заменено. InsertCommand UpdateCommand DeleteCommand В противном случае свойства и свойства сохраняют предыдущие значения.

При вызове DisposeOleDbCommandBuilder отсоединяется от OleDbDataAdapterнее, а созданные команды больше не используются.

Конструкторы

Имя	Описание
OleDbCommandBuilder()	Инициализирует новый экземпляр класса OleDbCommandBuilder.
OleDbCommandBuilder(OleDbDataAdapter)	Инициализирует новый экземпляр OleDbCommandBuilder класса с соответствующим OleDbDataAdapter объектом.

Свойства

Имя	Описание
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