DbCommandBuilder Classe

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DBCommandBuilder.cs

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::Component

public abstract class DbCommandBuilder : System.ComponentModel.Component

type DbCommandBuilder = class
    inherit Component

Public MustInherit Class DbCommandBuilder
Inherits Component

Herança

Object

MarshalByRefObject

Component

DbCommandBuilder

Derivado

System.Data.Odbc.OdbcCommandBuilder

System.Data.OleDb.OleDbCommandBuilder

System.Data.SqlClient.SqlCommandBuilder

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 @p#. Use quando estiver criando um construtor de comando personalizado.
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)

Confira também

• Gerando comandos com CommandBuilders
• Visão geral do ADO.NET