DbCommandBuilder Класс

Определение

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

System.Data.Common

Сборка:

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

System.Data.SqlClient.SqlCommandBuilder

Комментарии

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

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

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

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

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

также DbCommandBuilder использует Connectionсвойства , и Transaction , CommandTimeoutна которые ссылается 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	Указывает, включены все значения столбца в инструкции UPDATE или только измененные значения.
Site	Получает или задает ISite объекта Component. (Унаследовано от Component)

Методы

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Разрешает реализации поставщика класса DbCommandBuilder обрабатывать дополнительные свойства параметров.
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
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, Transaction, CommandType и 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)

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

• Создание команд с помощью построителей CommandBuilder
• Общие сведения об ADO.NET