OleDbCommandBuilder Classe

Definição

Espaço de Nomes:: System.Data.OleDb

Assemblagem:: System.Data.dll

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 que são usados para reconciliar alterações feitas em a DataSet com a base de dados associada. Esta classe não pode ser herdada.

public ref class OleDbCommandBuilder sealed : System::ComponentModel::Component

public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilder

public sealed class OleDbCommandBuilder : System.ComponentModel.Component

public sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilder

type OleDbCommandBuilder = class
    inherit Component

type OleDbCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OleDbCommandBuilder
Inherits Component

Public NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilder

Herança: Object

MarshalByRefObject

Component
OleDbCommandBuilder

Herança: Object

MarshalByRefObject

Component

DbCommandBuilder
OleDbCommandBuilder

Exemplos

O exemplo seguinte usa os OleDbCommand, along OleDbDataAdapter e OleDbConnection, para selecionar linhas de uma fonte de dados. O exemplo recebe uma DataSet inicializada, uma cadeia de ligação, uma cadeia de consulta que é uma instrução SQL SELECT e uma cadeia que é o nome da tabela da fonte de dados. O exemplo cria então 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

Observações

Não OleDbDataAdapter 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 OleDbCommandBuilder objeto para gerar automaticamente instruções SQL para atualizações de tabela única se definir a SelectCommand propriedade de .OleDbDataAdapter Depois, quaisquer instruções SQL adicionais que não definas são geradas pelo OleDbCommandBuilder.

Regista-se OleDbCommandBuilder como ouvinte de RowUpdating eventos sempre que defines a DataAdapter propriedade. Só pode associar um OleDbDataAdapter ou OleDbCommandBuilder objeto ao outro de cada vez.

Para gerar instruções INSERT, UPDATE ou DELETE, utiliza OleDbCommandBuilder a SelectCommand propriedade para recuperar automaticamente um conjunto necessário de metadados. Se alterar o SelectCommand método depois de os metadados serem recuperados, como após a primeira atualização, deve chamar o RefreshSchema método para atualizar os metadados.

O OleDbCommandBuilder também usa os Connection, CommandTimeout, e Transaction propriedades referenciadas pelos SelectCommand. O utilizador deve ligar RefreshSchema se uma ou mais destas propriedades forem modificadas, 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 OleDbCommandBuilder é dissociado do OleDbDataAdapter, e os comandos gerados deixam de ser usados.

Construtores

Name	Description
OleDbCommandBuilder()	Inicializa uma nova instância da OleDbCommandBuilder classe.
OleDbCommandBuilder(OleDbDataAdapter)	Inicializa uma nova instância da OleDbCommandBuilder classe com o objeto associado OleDbDataAdapter .

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. (Herdado de DbCommandBuilder)
CatalogSeparator	Recebe ou define uma string usada como separador de catálogo para uma instância da DbCommandBuilder classe. (Herdado de DbCommandBuilder)
ConflictOption	Especifica qual 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á 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.
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. (Herdado de DbCommandBuilder)
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.
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. (Herdado de DbCommandBuilder)
SchemaSeparator	Obtém ou define o carácter a ser usado como separador entre o identificador de esquema e quaisquer outros identificadores. (Herdado de DbCommandBuilder)
SetAllValues	Especifica se todos os valores das colunas numa instrução de atualização estão incluídos ou apenas os alterados. (Herdado de DbCommandBuilder)
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. (Herdado de DbCommandBuilder)
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)
DeriveParameters(OleDbCommand)	Recupera informação de parâmetros do procedimento armazenado especificado no OleDbCommand e preenche a Parameters coleção do objeto especificado OleDbCommand .
Dispose()	Liberta todos os recursos utilizados pelo Component. (Herdado de Component)
Dispose(Boolean)	Liberta os recursos não geridos usados pelo Component e opcionalmente liberta os recursos geridos. (Herdado de Component)
Dispose(Boolean)	Liberta os recursos não geridos usados pelo DbCommandBuilder e opcionalmente liberta os recursos geridos. (Herdado de DbCommandBuilder)
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 realizar eliminações na fonte dos dados.
GetDeleteCommand(Boolean)	Obtém o objeto gerado OleDbCommand automaticamente necessário para realizar eliminações na fonte dos dados.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetInsertCommand()	Obtém o objeto gerado OleDbCommand automaticamente necessário para realizar inserções na fonte de dados.
GetInsertCommand(Boolean)	Obtém o objeto gerado OleDbCommand automaticamente necessário para realizar inserções na fonte de dados.
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 `@p#`. Use ao criar um construtor de comandos personalizado. (Herdado de DbCommandBuilder)
GetParameterName(String)	Devolve o nome completo do parâmetro, dado o nome parcial do parâmetro. (Herdado de DbCommandBuilder)
GetParameterPlaceholder(Int32)	Devolve o marcador de posição para o parâmetro na instrução SQL associada. (Herdado de DbCommandBuilder)
GetSchemaTable(DbCommand)	Retorna a tabela de esquemas para o DbCommandBuilder. (Herdado de 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 OleDbCommand automaticamente necessário para realizar atualizações na fonte de dados.
GetUpdateCommand(Boolean)	Obtém o objeto gerado OleDbCommand 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. (Herdado de DbCommandBuilder)
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, OleDbConnection)	Dado um identificador não aspas, no caso correto do catálogo, retorna a forma correta e aspas. Isto inclui a fuga correta de quaisquer aspas embutidas no identificador.
QuoteIdentifier(String)	Dado um identificador não aspas, no caso correto do catálogo, retorna a forma correta e aspas. Isto inclui a fuga correta de quaisquer aspas embutidas no identificador.
RefreshSchema()	Limpa os comandos associados a este OleDbCommandBuilder.
RefreshSchema()	Limpa os comandos associados a este DbCommandBuilder. (Herdado de DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Adiciona um gestor de eventos para o RowUpdating evento. (Herdado de DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	Regista o DbCommandBuilder para gerir o RowUpdating evento para um DbDataAdapter. (Herdado de DbCommandBuilder)
ToString()	Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado. (Herdado de Component)
UnquoteIdentifier(String, OleDbConnection)	Dado um identificador entre aspas, devolve a forma correta e não astuta desse identificador. Isto inclui desfazer corretamente quaisquer aspas incorporadas no identificador.
UnquoteIdentifier(String)	Dado um identificador entre aspas, devolve a forma correta e não astuta desse identificador. Isto inclui desfazer corretamente quaisquer aspas incorporadas no identificador.

evento

Name	Description
Disposed	Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component)

Aplica-se a

Ver também

Gerando comandos com CommandBuilders

Comentários

Esta página foi útil?