DbCommandBuilder Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Gera automaticamente comandos de tabela única usados para reconciliar alterações feitas em um DataSet com o banco de dados associado. Esta é uma classe abstrata que só pode ser herdada.
public ref class DbCommandBuilder abstract : System::ComponentModel::Componentpublic abstract class DbCommandBuilder : System.ComponentModel.Componenttype DbCommandBuilder = class
inherit ComponentPublic MustInherit Class DbCommandBuilder
Inherits Component- Herança
- Derivado
Comentários
A DbCommandBuilder classe é fornecida para a conveniência dos gravadores de provedor criando seus próprios construtores de comandos. Ao herdar dessa classe, os desenvolvedores podem implementar um comportamento específico do provedor em seu próprio código.
O DbDataAdapter não gera automaticamente as instruções SQL necessárias para reconciliar as alterações feitas em uma DataSet fonte de dados associada. No entanto, você pode criar um DbCommandBuilder objeto para gerar automaticamente instruções SQL para atualizações de tabela única se definir a SelectCommand propriedade do DbDataAdapter. Em seguida, quaisquer instruções SQL adicionais que você não definir são geradas pelo DbCommandBuilder.
O DbCommandBuilder se registra como um ouvinte para RowUpdating eventos sempre que você define a DataAdapter propriedade. Você só pode associar um DbDataAdapter ou DbCommandBuilder objeto um ao outro ao mesmo tempo.
Para gerar instruções INSERT, UPDATE ou DELETE, a DbCommandBuilder propriedade usa a SelectCommand propriedade para recuperar automaticamente um conjunto necessário de metadados. Se você alterar o SelectCommand após a recuperação dos metadados (por exemplo, após a primeira atualização), deverá chamar o RefreshSchema método para atualizar os metadados.
O SelectCommand também deve retornar pelo menos uma chave primária ou coluna exclusiva. Se nenhum existir, uma exceção InvalidOperationException será gerada e os comandos não serão gerados.
O DbCommandBuilder também usa as Connectionpropriedades , CommandTimeoute Transaction referenciadas pelo SelectCommand. O usuário deve chamar RefreshSchema se alguma dessas propriedades for modificada ou se ela SelectCommand mesma for substituída. Caso contrário, as InsertCommandpropriedades e DeleteCommand as UpdateCommandpropriedades mantêm seus valores anteriores.
Se você chamar Dispose, o DbCommandBuilder valor será desassociado do DbDataAdaptere os comandos gerados não serão mais usados.
Construtores
| Nome | Description |
|---|---|
| DbCommandBuilder() |
Inicializa uma nova instância de uma classe que herda da DbCommandBuilder classe. |
Propriedades
| Nome | Description |
|---|---|
| CanRaiseEvents |
Obtém um valor que indica se o componente pode gerar um evento. (Herdado de Component) |
| CatalogLocation |
Obtém ou define o CatalogLocation para uma instância da DbCommandBuilder classe. |
| CatalogSeparator |
Obtém ou define uma cadeia de caracteres usada como separador de catálogo para uma instância da DbCommandBuilder classe. |
| ConflictOption |
Especifica o que ConflictOption deve ser usado pelo DbCommandBuilder. |
| Container |
Obtém o IContainer que contém o Component. (Herdado de Component) |
| DataAdapter |
Obtém ou define um DbDataAdapter objeto para o qual as instruções Transact-SQL são geradas automaticamente. |
| DesignMode |
Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component) |
| Events |
Obtém a lista de manipuladores de eventos anexados a isso Component. (Herdado de Component) |
| QuotePrefix |
Obtém ou define o caractere inicial ou os caracteres a serem usados ao especificar objetos de banco de dados (por exemplo, tabelas ou colunas) cujos nomes contêm caracteres como espaços ou tokens reservados. |
| QuoteSuffix |
Obtém ou define o caractere final ou caracteres a serem usados ao especificar objetos de banco de dados (por exemplo, tabelas ou colunas) cujos nomes contêm caracteres como espaços ou tokens reservados. |
| SchemaSeparator |
Obtém ou define o caractere a ser usado para o separador entre o identificador de esquema e quaisquer outros identificadores. |
| SetAllValues |
Especifica se todos os valores de coluna em uma instrução de atualização são incluídos ou apenas alterados. |
| Site |
Obtém ou define o ISiteComponent. (Herdado de Component) |
Métodos
| Nome | Description |
|---|---|
| ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean) |
Permite que a implementação do provedor da DbCommandBuilder classe manipule propriedades de parâmetro adicionais. |
| CreateObjRef(Type) |
Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Libera todos os recursos usados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo DbCommandBuilder e, opcionalmente, libera os recursos gerenciados. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetDeleteCommand() |
Obtém o objeto gerado DbCommand automaticamente necessário para executar exclusões na fonte de dados. |
| GetDeleteCommand(Boolean) |
Obtém o objeto gerado DbCommand automaticamente necessário para executar exclusões na fonte de dados, opcionalmente usando colunas para nomes de parâmetro. |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetInsertCommand() |
Obtém o objeto gerado DbCommand automaticamente necessário para executar inserções na fonte de dados. |
| GetInsertCommand(Boolean) |
Obtém o objeto gerado DbCommand automaticamente necessário para executar inserções na fonte de dados, opcionalmente usando colunas para nomes de parâmetro. |
| GetLifetimeService() |
Obsoleto.
Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| GetParameterName(Int32) |
Retorna o nome do parâmetro especificado no formato de |
| GetParameterName(String) |
Retorna o nome do parâmetro completo, dado o nome do parâmetro parcial. |
| GetParameterPlaceholder(Int32) |
Retorna o espaço reservado para o parâmetro na instrução SQL associada. |
| GetSchemaTable(DbCommand) |
Retorna a tabela de esquema para o DbCommandBuilder. |
| GetService(Type) |
Retorna um objeto que representa um serviço fornecido pelo Component ou por sua Container. (Herdado de Component) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUpdateCommand() |
Obtém o objeto gerado DbCommand automaticamente necessário para executar atualizações na fonte de dados. |
| GetUpdateCommand(Boolean) |
Obtém o objeto gerado DbCommand automaticamente necessário para executar atualizações na fonte de dados, opcionalmente usando colunas para nomes de parâmetro. |
| InitializeCommand(DbCommand) |
Redefine as CommandTimeoutpropriedades , e UpdateRowSourceTransactionCommandType, no DbCommand. |
| InitializeLifetimeService() |
Obsoleto.
Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| QuoteIdentifier(String) |
Dado um identificador não citado no caso de catálogo correto, retorna a forma correta entre aspas desse identificador, incluindo o escape adequado de aspas inseridas no identificador. |
| RefreshSchema() |
Limpa os comandos associados a isso DbCommandBuilder. |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Adiciona um processador de eventos para o RowUpdating evento. |
| SetRowUpdatingHandler(DbDataAdapter) |
Registra o DbCommandBuilder para manipular o RowUpdating evento para um DbDataAdapter. |
| ToString() |
Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component) |
| UnquoteIdentifier(String) |
Dado um identificador entre aspas, retorna a forma não cotada correta desse identificador, incluindo o descontrole adequado de todas as aspas inseridas no identificador. |
Eventos
| Nome | Description |
|---|---|
| Disposed |
Ocorre quando o componente é descartado por uma chamada para o Dispose() método. (Herdado de Component) |
