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 os comandos de tabela única usados para reconciliar as alterações feitas em um DataSet com o banco de dados associado. Isso é 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 um DataSet com a 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, todas as 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 objeto ou DbCommandBuilder ao outro ao mesmo tempo.
Para gerar instruções INSERT, UPDATE ou DELETE, o DbCommandBuilder 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 exclusivo. 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 qualquer uma dessas propriedades for modificada ou se o SelectCommand próprio for substituído. Caso contrário, as InsertCommandpropriedades , UpdateCommande DeleteCommand mantêm seus valores anteriores.
Se você chamar Dispose, o DbCommandBuilder será desassociado do DbDataAdaptere os comandos gerados não serão mais usados.
Construtores
| DbCommandBuilder() |
Inicializa uma nova instância de uma classe que herda da classe DbCommandBuilder. |
Propriedades
| CanRaiseEvents |
Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component) |
| CatalogLocation |
Obtém ou define o CatalogLocation para uma instância da classe DbCommandBuilder. |
| CatalogSeparator |
Obtém ou define uma cadeia de caracteres usada como o separador de catálogo para uma instância da classe DbCommandBuilder. |
| ConflictOption |
Especifica qual 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 objeto DbDataAdapter para o qual as instruções do 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 que estão anexados a este Component. (Herdado de Component) |
| QuotePrefix |
Obtém ou define o caractere ou caracteres iniciais a serem usados ao especificar os 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 ou caracteres finais a serem usados ao especificar os 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 do esquema e de quaisquer outros identificadores. |
| SetAllValues |
Especifica se todos os valores de coluna em uma declaração de atualização são incluídos ou apenas aqueles alterados. |
| Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
Métodos
| ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean) |
Permite a implementação de provedor da classe DbCommandBuilder para manipular 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 DbCommand gerado automaticamente necessário para realizar exclusões na fonte de dados. |
| GetDeleteCommand(Boolean) |
Obtém o objeto DbCommand gerado automaticamente necessário para realizar exclusões na fonte de dados, opcionalmente usando colunas para nomes de parâmetros. |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetInsertCommand() |
Obtém o objeto DbCommand gerado automaticamente necessário para realizar inserções na fonte de dados. |
| GetInsertCommand(Boolean) |
Obtém o objeto DbCommand gerado automaticamente necessário para realizar inserções na fonte de dados, opcionalmente usando colunas para nomes de parâmetros. |
| GetLifetimeService() |
Obsoleto.
Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject) |
| GetParameterName(Int32) |
Retorna o nome do parâmetro especificado no formato de |
| GetParameterName(String) |
Retorna o nome completo do parâmetro, considerando o nome parcial do parâmetro. |
| 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 pelo seu Container. (Herdado de Component) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUpdateCommand() |
Obtém o objeto DbCommand gerado automaticamente necessário para realizar atualizações na fonte de dados. |
| GetUpdateCommand(Boolean) |
Obtém o objeto DbCommand gerado automaticamente necessário para realizar atualizações na fonte de dados, opcionalmente usando colunas para nomes de parâmetros. |
| InitializeCommand(DbCommand) |
Redefine as propriedades CommandTimeout, Transaction, CommandType e UpdateRowSource no DbCommand. |
| InitializeLifetimeService() |
Obsoleto.
Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject) |
| QuoteIdentifier(String) |
Dado um identificador sem aspas no caso de catálogo correto, retorna a forma entre aspas correta desse identificador, incluindo o escape apropriado de quaisquer aspas inseridas no identificador. |
| RefreshSchema() |
Limpa os comandos associados a este DbCommandBuilder. |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Adiciona um manipulador de eventos para o evento RowUpdating. |
| SetRowUpdatingHandler(DbDataAdapter) |
Registra o DbCommandBuilder para lidar com o evento RowUpdating 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 sem aspas correta desse identificador, incluindo desfazer o escape adequado de quaisquer aspas inseridas no identificador. |
Eventos
| Disposed |
Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component) |
