DbCommandBuilder Класс

Определение

Пространство имен:

System.Data.Common

Сборки:

netstandard.dll, System.Data.Common.dll

Исходный код:

DBCommandBuilder.cs

Автоматически создает команды с одной таблицей, используемые для согласования изменений, внесенных DataSet в связанную базу данных. Это абстрактный класс, который может быть унаследован только.

public ref class DbCommandBuilder abstract : System::ComponentModel::Component

public abstract class DbCommandBuilder : System.ComponentModel.Component

type DbCommandBuilder = class
    inherit Component

Public MustInherit Class DbCommandBuilder
Inherits Component

Наследование

Object

MarshalByRefObject

Component

DbCommandBuilder

Производный

System.Data.Odbc.OdbcCommandBuilder

System.Data.OleDb.OleDbCommandBuilder

Комментарии

Класс DbCommandBuilder предоставляется для удобства разработчиков поставщиков, создающих собственные построители команд. Наследуя от этого класса, разработчики могут реализовать конкретное поведение поставщика в собственном коде.

Инструкции DbDataAdapter SQL, необходимые для согласования изменений, внесенных DataSet в связанный источник данных, не создаются автоматически. Однако можно создать DbCommandBuilder объект для автоматического создания инструкций SQL для одно табличных обновлений, если задать SelectCommand свойство объекта DbDataAdapter. Затем все дополнительные инструкции SQL, которые не заданы, создаются этим параметром DbCommandBuilder.

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

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

Свойство SelectCommand должно также вернуть по крайней мере один первичный ключ или уникальный столбец. Если нет, InvalidOperationException создается исключение, и команды не создаются.

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

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

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

Имя	Описание
DbCommandBuilder()	Инициализирует новый экземпляр класса, наследуемого DbCommandBuilder от класса.

Свойства

Имя	Описание
CanRaiseEvents	Возвращает значение, указывающее, может ли компонент вызвать событие. (Унаследовано от Component)
CatalogLocation	Возвращает или задает CatalogLocation экземпляр DbCommandBuilder класса.
CatalogSeparator	Возвращает или задает строку, используемую в качестве разделителя каталога для экземпляра DbCommandBuilder класса.
ConflictOption	Указывает, какой ConflictOption объект должен использоваться параметром DbCommandBuilder.
Container	Возвращает объект IContainer , содержащий Componentобъект . (Унаследовано от Component)
DataAdapter	Возвращает или задает DbDataAdapter объект, для которого автоматически создаются операторы Transact-SQL.
DesignMode	Возвращает значение, указывающее, находится ли текущий Component режим разработки. (Унаследовано от Component)
Events	Возвращает список обработчиков событий, подключенных к этому Component. (Унаследовано от Component)
QuotePrefix	Возвращает или задает начальный символ или символы, используемые при указании объектов базы данных (например, таблиц или столбцов), имена которых содержат такие символы, как пробелы или зарезервированные маркеры.
QuoteSuffix	Возвращает или задает конечный символ или символы, используемые при указании объектов базы данных (например, таблиц или столбцов), имена которых содержат такие символы, как пробелы или зарезервированные маркеры.
SchemaSeparator	Возвращает или задает символ, используемый для разделителя между идентификатором схемы и любыми другими идентификаторами.
SetAllValues	Указывает, включены ли все значения столбцов в инструкции обновления или только изменены.
Site	Возвращает или задает ISite объект Component. (Унаследовано от Component)

Методы

Имя	Описание
ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Позволяет поставщику реализовать класс для обработки дополнительных DbCommandBuilder свойств параметров.
Dispose()	Освобождает все ресурсы, используемые параметром Component. (Унаследовано от Component)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые DbCommandBuilder и при необходимости освобождает управляемые ресурсы.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetDeleteCommand()	Возвращает автоматически созданный DbCommand объект, необходимый для удаления в источнике данных.
GetDeleteCommand(Boolean)	Возвращает автоматически созданный DbCommand объект, необходимый для удаления в источнике данных, при необходимости используя столбцы для имен параметров.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetInsertCommand()	Возвращает автоматически созданный DbCommand объект, необходимый для выполнения вставок в источник данных.
GetInsertCommand(Boolean)	Возвращает автоматически созданный DbCommand объект, необходимый для выполнения вставок в источник данных, при необходимости используя столбцы для имен параметров.
GetLifetimeService()	Устаревшие.. Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
GetParameterName(Int32)	Возвращает имя указанного параметра в формате @p#. Используется при создании пользовательского построителя команд.
GetParameterName(String)	Возвращает полное имя параметра, учитывая частичное имя параметра.
GetParameterPlaceholder(Int32)	Возвращает заполнитель для параметра в связанной инструкции SQL.
GetSchemaTable(DbCommand)	Возвращает таблицу схемы для .DbCommandBuilder
GetService(Type)	Возвращает объект, представляющий службу, предоставляемую Component или ее Container. (Унаследовано от Component)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetUpdateCommand()	Возвращает автоматически созданный DbCommand объект, необходимый для выполнения обновлений в источнике данных.
GetUpdateCommand(Boolean)	Возвращает автоматически созданный DbCommand объект, необходимый для выполнения обновлений в источнике данных, при необходимости используя столбцы для имен параметров.
InitializeCommand(DbCommand)	Сбрасывает CommandTimeoutзначения , TransactionCommandTypeи UpdateRowSource свойства в элементе DbCommand.
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неглубокую копию текущего MarshalByRefObject объекта. (Унаследовано от MarshalByRefObject)
QuoteIdentifier(String)	Учитывая неквотированный идентификатор в правильном регистре каталога, возвращает правильную кавыченую форму этого идентификатора, включая правильное экранирование всех внедренных кавычки в идентификаторе.
RefreshSchema()	Очищает команды, связанные с этим DbCommandBuilder.
RowUpdatingHandler(RowUpdatingEventArgs)	Добавляет обработчик событий для RowUpdating события.
SetRowUpdatingHandler(DbDataAdapter)	Регистрирует DbCommandBuilder событие RowUpdating для события DbDataAdapter.
ToString()	String Возвращает имя, содержащее имя , если таковое Componentимеется. Этот метод не должен быть переопределен. (Унаследовано от Component)
UnquoteIdentifier(String)	При наличии кавычек идентификатор возвращает правильную неквалированную форму этого идентификатора, в том числе правильную отмену всех внедренных кавычки в идентификаторе.

События

Имя	Описание
Disposed	Происходит при удалении компонента вызовом Dispose() метода. (Унаследовано от Component)

См. также раздел

• Создание команд с помощью CommandBuilders
• Общие сведения об ADO.NET