OleDbCommandBuilder 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 que são usados para reconciliar as alterações feitas em um DataSet com o banco de dados associado. Essa classe não pode ser herdada.
public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilderpublic ref class OleDbCommandBuilder sealed : System::ComponentModel::Componentpublic sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilderpublic sealed class OleDbCommandBuilder : System.ComponentModel.Componenttype OleDbCommandBuilder = class
inherit DbCommandBuildertype OleDbCommandBuilder = class
inherit ComponentPublic NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilderPublic NotInheritable Class OleDbCommandBuilder
Inherits Component- Herança
- Herança
Exemplos
O exemplo a seguir usa o OleDbCommand, junto OleDbDataAdapter e OleDbConnection, para selecionar linhas de uma fonte de dados. O exemplo é passado por uma cadeia de conexão inicializada DataSet, uma cadeia de conexão, uma cadeia de caracteres de consulta que é uma instrução SQL SELECT e uma cadeia de caracteres que é o nome da tabela de fonte de dados. Em seguida, o exemplo cria um OleDbCommandBuilder.
public static DataSet UpdateRows(string connectionString,
string queryString, string tableName)
{
DataSet dataSet = new DataSet();
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbDataAdapter adapter = new OleDbDataAdapter();
adapter.SelectCommand = new OleDbCommand(queryString, connection);
OleDbCommandBuilder cb = new OleDbCommandBuilder(adapter);
connection.Open();
adapter.Fill(dataSet, tableName);
//code to modify data in DataSet here
cb.GetDeleteCommand();
//Without the OleDbCommandBuilder this line would fail
adapter.Update(dataSet, tableName);
connection.Close();
}
return dataSet;
}
Public Shared Function UpdateRows(ByVal connectionString As String, _
ByVal queryString As String, ByVal tableName As String) As DataSet
Dim dataSet As New DataSet()
Using connection As New OleDbConnection(connectionString)
Dim adapter As New OleDbDataAdapter()
adapter.SelectCommand = New OleDbCommand(queryString, connection)
Dim builder As New OleDbCommandBuilder(adapter)
connection.Open()
adapter.Fill(dataSet, tableName)
' Code to modify data in DataSet here
builder.GetUpdateCommand()
' Without the OleDbCommandBuilder this line would fail.
adapter.Update(dataSet, tableName)
End Using
Return dataSet
End Function
Comentários
O OleDbDataAdapter 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 OleDbCommandBuilder objeto para gerar automaticamente instruções SQL para atualizações de tabela única se definir a SelectCommand propriedade do OleDbDataAdapter. Em seguida, quaisquer instruções SQL adicionais que você não definir são geradas pelo OleDbCommandBuilder.
O OleDbCommandBuilder se registra como um ouvinte para RowUpdating eventos sempre que você define a DataAdapter propriedade. Você só pode associar um OleDbDataAdapter ou OleDbCommandBuilder objeto um ao outro ao mesmo tempo.
Para gerar instruções INSERT, UPDATE ou DELETE, a OleDbCommandBuilder propriedade usa a SelectCommand propriedade para recuperar automaticamente um conjunto necessário de metadados. Se você alterar depois que SelectCommand os metadados forem recuperados, como após a primeira atualização, você deverá chamar o RefreshSchema método para atualizar os metadados.
O OleDbCommandBuilder também usa as Connectionpropriedades , CommandTimeoute Transaction referenciadas pelo SelectCommand. O usuário deve chamar RefreshSchema se uma ou mais dessas propriedades forem modificadas ou se elas SelectCommand forem substituídas. Caso contrário, as InsertCommandpropriedades e DeleteCommand as UpdateCommandpropriedades mantêm seus valores anteriores.
Se você chamar Dispose, o OleDbCommandBuilder valor será desassociado do OleDbDataAdaptere os comandos gerados não serão mais usados.
Construtores
| Nome | Description |
|---|---|
| OleDbCommandBuilder() |
Inicializa uma nova instância da classe OleDbCommandBuilder. |
| OleDbCommandBuilder(OleDbDataAdapter) |
Inicializa uma nova instância da OleDbCommandBuilder classe com o objeto associado OleDbDataAdapter . |
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. (Herdado de DbCommandBuilder) |
| CatalogSeparator |
Obtém ou define uma cadeia de caracteres usada como separador de catálogo para uma instância da DbCommandBuilder classe. (Herdado de DbCommandBuilder) |
| ConflictOption |
Especifica o que ConflictOption deve ser usado pelo DbCommandBuilder. (Herdado de DbCommandBuilder) |
| Container |
Obtém o IContainer que contém o Component. (Herdado de Component) |
| DataAdapter |
Obtém ou define um OleDbDataAdapter objeto para o qual as instruções 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. |
| 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. (Herdado de DbCommandBuilder) |
| 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. |
| 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. (Herdado de DbCommandBuilder) |
| SchemaSeparator |
Obtém ou define o caractere a ser usado para o separador entre o identificador de esquema e quaisquer outros identificadores. (Herdado de DbCommandBuilder) |
| SetAllValues |
Especifica se todos os valores de coluna em uma instrução de atualização são incluídos ou apenas alterados. (Herdado de DbCommandBuilder) |
| 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. (Herdado de DbCommandBuilder) |
| 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) |
| DeriveParameters(OleDbCommand) |
Recupera informações de parâmetro do procedimento armazenado especificado e OleDbCommand preenche a Parameters coleção do objeto especificado OleDbCommand . |
| 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. (Herdado de DbCommandBuilder) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo Component e, opcionalmente, libera os recursos gerenciados. (Herdado de Component) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetDeleteCommand() |
Obtém o objeto gerado OleDbCommand automaticamente necessário para executar exclusões na fonte de dados. |
| GetDeleteCommand(Boolean) |
Obtém o objeto gerado OleDbCommand automaticamente necessário para executar exclusões na fonte de dados. |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetInsertCommand() |
Obtém o objeto gerado OleDbCommand automaticamente necessário para executar inserções na fonte de dados. |
| GetInsertCommand(Boolean) |
Obtém o objeto gerado OleDbCommand automaticamente necessário para executar inserções na fonte de dados. |
| 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. (Herdado de DbCommandBuilder) |
| GetParameterPlaceholder(Int32) |
Retorna o espaço reservado para o parâmetro na instrução SQL associada. (Herdado de DbCommandBuilder) |
| GetSchemaTable(DbCommand) |
Retorna a tabela de esquema para o DbCommandBuilder. (Herdado de 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 OleDbCommand automaticamente necessário para executar atualizações na fonte de dados. |
| GetUpdateCommand(Boolean) |
Obtém o objeto gerado OleDbCommand 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. (Herdado de DbCommandBuilder) |
| 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, OleDbConnection) |
Dado um identificador não citado no caso de catálogo correto, retorna a forma correta entre aspas desse identificador. Isso inclui o escape correto de aspas inseridas no identificador. |
| QuoteIdentifier(String) |
Dado um identificador não citado no caso de catálogo correto, retorna a forma correta entre aspas desse identificador. Isso inclui o escape correto de aspas inseridas no identificador. |
| RefreshSchema() |
Limpa os comandos associados a isso OleDbCommandBuilder. |
| RefreshSchema() |
Limpa os comandos associados a isso DbCommandBuilder. (Herdado de DbCommandBuilder) |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Adiciona um processador de eventos para o RowUpdating evento. (Herdado de DbCommandBuilder) |
| SetRowUpdatingHandler(DbDataAdapter) |
Registra o DbCommandBuilder para manipular o RowUpdating evento para um DbDataAdapter. (Herdado de DbCommandBuilder) |
| 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, OleDbConnection) |
Dado um identificador entre aspas, retorna a forma não citada correta desse identificador. Isso inclui cancelar corretamente o escape de aspas inseridas no identificador. |
| UnquoteIdentifier(String) |
Dado um identificador entre aspas, retorna a forma não citada correta desse identificador. Isso inclui cancelar corretamente o escape de aspas inseridas no identificador. |
Eventos
| Nome | Description |
|---|---|
| Disposed |
Ocorre quando o componente é descartado por uma chamada para o Dispose() método. (Herdado de Component) |
