DbCommandBuilder Класс

Определение

Автоматически создает однотабличные команды, которые позволяют согласовать изменения, внесенные в DataSet, со связанной базой данных.Automatically generates single-table commands used to reconcile changes made to a DataSet with the associated database. Это абстрактный класс, который может только наследоваться.This is an abstract class that can only be inherited.

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
Наследование

Комментарии

DbCommandBuilder Класс предоставляется для удобства создателей поставщиков, создающих собственные средства построения команд.The DbCommandBuilder class is provided for the convenience of provider writers creating their own command builders. При наследовании от этого класса разработчики могут реализовать поведение конкретного поставщика в своем собственном коде.By inheriting from this class, developers can implement provider specific behavior in their own code.

Не создает автоматически инструкции SQL, необходимые для согласования изменений, внесенных в, DataSet с соответствующим источником данных. DbDataAdapterThe DbDataAdapter does not automatically generate the SQL statements required to reconcile changes made to a DataSet with the associated data source. Однако можно создать DbCommandBuilder объект для автоматического создания инструкций SQL для однотабличных обновлений, если SelectCommand задать свойство объекта DbDataAdapter.However, you can create a DbCommandBuilder object to automatically generate SQL statements for single-table updates if you set the SelectCommand property of the DbDataAdapter. Затем все дополнительные инструкции SQL, которые не заданы, создаются DbCommandBuilder.Then, any additional SQL statements that you do not set are generated by the DbCommandBuilder.

Регистрируется как прослушиватель для RowUpdating DataAdapter событий при установке свойства. DbCommandBuilderThe DbCommandBuilder registers itself as a listener for RowUpdating events whenever you set the DataAdapter property. В один момент времени можно DbDataAdapter связать DbCommandBuilder только один объект или.You can only associate one DbDataAdapter or DbCommandBuilder object with each other at one time.

Чтобы создать инструкции INSERT, UPDATE или DELETE, DbCommandBuilder SelectCommand компонент использует свойство для автоматического извлечения требуемого набора метаданных.To generate INSERT, UPDATE, or DELETE statements, the DbCommandBuilder uses the SelectCommand property to retrieve a required set of metadata automatically. При изменении SelectCommand после получения метаданных (например, после первого обновления) следует RefreshSchema вызвать метод для обновления метаданных.If you change the SelectCommand after the metadata has been retrieved (for example, after the first update), you should call the RefreshSchema method to update the metadata.

Свойство SelectCommand должно также возвратить по крайней мере один столбец первичного ключа или столбец с атрибутом UNIQUE.The SelectCommand must also return at least one primary key or unique column. Если не существует, InvalidOperationException создается исключение и команды не создаются.If none exist, an InvalidOperationException exception is generated, and the commands are not generated.

В DbCommandBuilder CommandTimeoutтакже SelectCommandиспользуются свойства Connection, и Transaction , на которые ссылается.The DbCommandBuilder also uses the Connection, CommandTimeout, and Transaction properties referenced by the SelectCommand. Пользователь должен вызвать RefreshSchema , если какое-либо из этих свойств изменяется, или значение SelectCommand , если оно заменено.The user should call RefreshSchema if any of these properties are modified, or if the SelectCommand itself is replaced. В противном UpdateCommandслучае свойства DeleteCommand,и сохраняют свои предыдущие значения. InsertCommandOtherwise the InsertCommand, UpdateCommand, and DeleteCommand properties retain their previous values.

При вызове Disposeметод DbCommandBuilder не связывается с ,асозданныекомандыбольшенеиспользуются.DbDataAdapterIf you call Dispose, the DbCommandBuilder is disassociated from the DbDataAdapter, and the generated commands are no longer used.

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

DbCommandBuilder()

Инициализирует новый экземпляр класса, который наследует от класса DbCommandBuilder.Initializes a new instance of a class that inherits from the DbCommandBuilder class.

Свойства

CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Унаследовано от Component)
CatalogLocation

Возвращает или задает CatalogLocation для экземпляра класса DbCommandBuilder.Sets or gets the CatalogLocation for an instance of the DbCommandBuilder class.

CatalogSeparator

Возвращает или задает строку, которую можно использовать в качестве разделителя каталогов, для экземпляра класса DbCommandBuilder.Sets or gets a string used as the catalog separator for an instance of the DbCommandBuilder class.

ConflictOption

Указывает, какое значение типа ConflictOption должно использоваться объектом DbCommandBuilder.Specifies which ConflictOption is to be used by the DbCommandBuilder.

Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Унаследовано от Component)
DataAdapter

Возвращает или задает объект DbDataAdapter, для которого автоматически создаются инструкции Transact-SQL.Gets or sets a DbDataAdapter object for which Transact-SQL statements are automatically generated.

DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component)
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component)
QuotePrefix

Возвращает или задает начальный символ или символы, используемые для указания объектов базы данных (например, таблиц или столбцов), имена которых содержат такие символы, как пробелы или зарезервированные токены.Gets or sets the beginning character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

QuoteSuffix

Получает или задает конечный символ или символы, используемые для указания объектов базы данных (например, таблиц или столбцов), имена которых содержат такие символы, как пробелы или зарезервированные токены.Gets or sets the ending character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

SchemaSeparator

Возвращает или задает символ, который используется в качестве разделителя между идентификатором схемы и остальными идентификаторами.Gets or sets the character to be used for the separator between the schema identifier and any other identifiers.

SetAllValues

Указывает, включены все значения столбца в инструкции UPDATE или только измененные значения.Specifies whether all column values in an update statement are included or only changed ones.

Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Унаследовано от Component)

Методы

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)

Разрешает реализации поставщика класса DbCommandBuilder обрабатывать дополнительные свойства параметров.Allows the provider implementation of the DbCommandBuilder class to handle additional parameter properties.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом DbCommandBuilder, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the DbCommandBuilder and optionally releases the managed resources.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetDeleteCommand()

Возвращает автоматически созданный объект DbCommand, который требуется для выполнения операций удаления в источнике данных.Gets the automatically generated DbCommand object required to perform deletions at the data source.

GetDeleteCommand(Boolean)

Возвращает автоматически созданный объект DbCommand, который требуется для выполнения операций удаления в источнике данных (дополнительно могут использоваться имена столбцов для определения имен параметров).Gets the automatically generated DbCommand object required to perform deletions at the data source, optionally using columns for parameter names.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetInsertCommand()

Возвращает автоматически созданный объект DbCommand, который требуется для выполнения операций вставки в источнике данных.Gets the automatically generated DbCommand object required to perform insertions at the data source.

GetInsertCommand(Boolean)

Возвращает автоматически созданный объект DbCommand, который требуется для выполнения операций вставки в источнике данных (дополнительно могут использоваться столбцы для определения имен параметров).Gets the automatically generated DbCommand object required to perform insertions at the data source, optionally using columns for parameter names.

GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetParameterName(Int32)

Возвращает имя указанного параметра в формате @p#.Returns the name of the specified parameter in the format of @p#. Используется при создании пользовательского построителя команд.Use when building a custom command builder.

GetParameterName(String)

Возвращает полное имя параметра при данном частичном имени параметра.Returns the full parameter name, given the partial parameter name.

GetParameterPlaceholder(Int32)

Возвращает местозаполнитель для параметра в связанной инструкции SQL.Returns the placeholder for the parameter in the associated SQL statement.

GetSchemaTable(DbCommand)

Возвращает таблицу схемы для объекта DbCommandBuilder.Returns the schema table for the DbCommandBuilder.

GetService(Type)

Возвращает объект, представляющий службу, обеспечиваемую компонентом Component или его контейнером Container.Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetUpdateCommand()

Возвращает автоматически созданный объект DbCommand, который требуется для выполнения операций обновления в источнике данных.Gets the automatically generated DbCommand object required to perform updates at the data source.

GetUpdateCommand(Boolean)

Возвращает автоматически созданный объект DbCommand, который требуется для выполнения операций обновления в источнике данных (дополнительно могут использоваться столбцы для определения имен параметров).Gets the automatically generated DbCommand object required to perform updates at the data source, optionally using columns for parameter names.

InitializeCommand(DbCommand)

Сбрасывает свойства CommandTimeout, Transaction, CommandType и UpdateRowSource в объекте DbCommand.Resets the CommandTimeout, Transaction, CommandType, and UpdateRowSource properties on the DbCommand.

InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
QuoteIdentifier(String)

Если у идентификатора нет кавычек, при наличии правильного каталога возвращает правильную форму этого идентификатора, взятую в кавычки, при этом корректно избегает кавычек, встроенных в идентификатор.Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier, including properly escaping any embedded quotes in the identifier.

RefreshSchema()

Очищает команды, связанные с этим объектом DbCommandBuilder.Clears the commands associated with this DbCommandBuilder.

RowUpdatingHandler(RowUpdatingEventArgs)

Добавляет обработчик событий для события RowUpdating.Adds an event handler for the RowUpdating event.

SetRowUpdatingHandler(DbDataAdapter)

Регистрирует объект DbCommandBuilder, чтобы обработать событие RowUpdating для объекта DbDataAdapter.Registers the DbCommandBuilder to handle the RowUpdating event for a DbDataAdapter.

ToString()

Возвращает объект String, содержащий имя Component, если оно есть.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

(Унаследовано от Component)
UnquoteIdentifier(String)

Если у идентификатора есть кавычки, возвращает форму этого идентификатора без кавычек, при этом корректно учитывая кавычки, встроенные в идентификатор.Given a quoted identifier, returns the correct unquoted form of that identifier, including properly un-escaping any embedded quotes in the identifier.

События

Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component)

Применяется к

Дополнительно