DbCommandBuilder Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Gera automaticamente comandos de tabela única usados para reconciliar alterações feitas a DataSet a com a base de dados associada. 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
Observações
A DbCommandBuilder aula é oferecida para a conveniência dos escritores de fornecedores que criam os seus próprios construtores de comandos. Ao herdar desta classe, os programadores podem implementar comportamentos específicos do fornecedor no seu próprio código.
Não DbDataAdapter gera automaticamente as instruções SQL necessárias para conciliar alterações feitas em a DataSet com a fonte de dados associada. No entanto, pode criar um DbCommandBuilder objeto para gerar automaticamente instruções SQL para atualizações de tabela única se definir a SelectCommand propriedade de .DbDataAdapter Depois, quaisquer instruções SQL adicionais que não definas são geradas pelo DbCommandBuilder.
Regista-se DbCommandBuilder como ouvinte de RowUpdating eventos sempre que defines a DataAdapter propriedade. Só pode associar um DbDataAdapter ou DbCommandBuilder objeto ao outro de cada vez.
Para gerar instruções INSERT, UPDATE ou DELETE, utiliza DbCommandBuilder a SelectCommand propriedade para recuperar automaticamente um conjunto necessário de metadados. Se alterar o SelectCommand método depois de os metadados terem sido recuperados (por exemplo, após a primeira atualização), deve 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 não existirem, é gerada uma InvalidOperationException exceção, e os comandos não são gerados.
O DbCommandBuilder também usa os Connection, CommandTimeout, e Transaction propriedades referenciadas pelos SelectCommand. O utilizador deve contactar RefreshSchema se alguma destas propriedades foi modificada, ou se a SelectCommand própria propriedade for substituída. Caso contrário, as InsertCommandpropriedades , UpdateCommand, e DeleteCommand mantêm os seus valores anteriores.
Se chamar Dispose, o DbCommandBuilder é dissociado do DbDataAdapter, e os comandos gerados deixam de ser usados.
Construtores
| Name | Description |
|---|---|
| DbCommandBuilder() |
Inicializa uma nova instância de uma classe que herda da DbCommandBuilder classe. |
Propriedades
| Name | Description |
|---|---|
| CanRaiseEvents |
Obtém um valor que indica se o componente pode gerar um evento. (Herdado de Component) |
| CatalogLocation |
Obtém ou define para CatalogLocation uma instância da DbCommandBuilder classe. |
| CatalogSeparator |
Recebe ou define uma string usada como separador de catálogo para uma instância da DbCommandBuilder classe. |
| 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 Transact-SQL instruções são geradas automaticamente. |
| DesignMode |
Obtém um valor que indica se o Component está atualmente em modo de design. (Herdado de Component) |
| Events |
Obtém a lista de gestores de eventos que estão ligados a isto Component. (Herdado de Component) |
| QuotePrefix |
Obtém ou define o carácter inicial ou caracteres a usar ao especificar objetos da base de dados (por exemplo, tabelas ou colunas) cujos nomes contêm caracteres como espaços ou tokens reservados. |
| QuoteSuffix |
Obtém ou define o carácter final ou caracteres a usar ao especificar objetos de base de dados (por exemplo, tabelas ou colunas) cujos nomes contêm caracteres como espaços ou tokens reservados. |
| SchemaSeparator |
Obtém ou define o carácter a ser usado como separador entre o identificador de esquema e quaisquer outros identificadores. |
| SetAllValues |
Especifica se todos os valores das colunas numa instrução de atualização estão incluídos ou apenas os alterados. |
| Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
Métodos
| Name | Description |
|---|---|
| ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean) |
Permite que a implementação provedora da DbCommandBuilder classe trate de propriedades adicionais dos parâmetros. |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Liberta todos os recursos utilizados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pelo DbCommandBuilder e opcionalmente liberta os recursos geridos. |
| 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 realizar eliminações na fonte dos dados. |
| GetDeleteCommand(Boolean) |
Obtém o objeto gerado DbCommand automaticamente necessário para realizar eliminações na fonte de dados, opcionalmente usando colunas para nomes de parâmetros. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetInsertCommand() |
Obtém o objeto gerado DbCommand automaticamente necessário para realizar inserções na fonte de dados. |
| GetInsertCommand(Boolean) |
Obtém o objeto gerado DbCommand automaticamente necessário para realizar inserções na fonte de dados, optativamente usando colunas para nomes de parâmetros. |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetParameterName(Int32) |
Devolve o nome do parâmetro especificado no formato de |
| GetParameterName(String) |
Devolve o nome completo do parâmetro, dado o nome parcial do parâmetro. |
| GetParameterPlaceholder(Int32) |
Devolve o marcador de posição para o parâmetro na instrução SQL associada. |
| GetSchemaTable(DbCommand) |
Retorna a tabela de esquemas para o DbCommandBuilder. |
| GetService(Type) |
Devolve 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 gerado DbCommand automaticamente necessário para realizar atualizações na fonte de dados. |
| GetUpdateCommand(Boolean) |
Obtém o objeto gerado DbCommand automaticamente necessário para realizar atualizações na fonte de dados, optativamente usando colunas para nomes de parâmetros. |
| InitializeCommand(DbCommand) |
Reinicia os CommandTimeout, Transaction, CommandType, e UpdateRowSource propriedades no DbCommand. |
| InitializeLifetimeService() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| QuoteIdentifier(String) |
Dado um identificador não aspas, no caso correto do catálogo, devolve a forma correta entre aspas desse identificador, incluindo a saída correta de quaisquer aspas embutidas no identificador. |
| RefreshSchema() |
Limpa os comandos associados a este DbCommandBuilder. |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Adiciona um gestor de eventos para o RowUpdating evento. |
| SetRowUpdatingHandler(DbDataAdapter) |
Regista o DbCommandBuilder para gerir o RowUpdating evento para um DbDataAdapter. |
| ToString() |
Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado. (Herdado de Component) |
| UnquoteIdentifier(String) |
Dado um identificador entre aspas, devolve a forma correta e não aspas, incluindo o des-escape adequado de quaisquer aspas embutidas no identificador. |
evento
| Name | Description |
|---|---|
| Disposed |
Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component) |