OracleCommandBuilder Classe

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Cuidado

OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Gera automaticamente os comandos de tabela única 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 OracleCommandBuilder sealed : System::Data::Common::DbCommandBuilder

[System.Obsolete("OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleCommandBuilder : System.Data.Common.DbCommandBuilder

[<System.Obsolete("OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OracleCommandBuilder
Inherits DbCommandBuilder

Herança

Object

MarshalByRefObject

Component

DbCommandBuilder

OracleCommandBuilder

Atributos

ObsoleteAttribute

Exemplos

O exemplo a seguir usa OracleCommand, juntamente com OracleDataAdapter e OracleConnection, para selecionar linhas de um banco de dados. O exemplo é passado um inicializado DataSet, um 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 banco de dados. Em seguida, o exemplo cria um OracleCommandBuilder.

Private Function SelectOracleRows(connection As String, queryString As String, tableName As String) As DataSet  

   Dim connection As New OracleConnection(connection)  
   Dim dataAdapter As New OracleDataAdapter()  
   Dim dataSet As DataSet = New DataSet  

   dataAdapter.SelectCommand = New OracleCommand(queryString, connection)  

   Dim cmdBuilder As OracleCommandBuilder = New OracleCommandBuilder(dataAdapter)  

   connection.Open()  
   dataAdapter.Fill(dataSet, tableName)  
      ' Code to modify data in DataSet here   
      ' Without the OracleCommandBuilder this line would fail.  
   dataAdapter.Update(dataSet, tableName)  
   connection.Close()  
End Function  

public static DataSet SelectOracleSrvRows(string myConnection, string mySelectQuery, string myTableName)  
{  
   OracleConnection myConn = new OracleConnection(myConnection);  
   OracleDataAdapter myDataAdapter = new OracleDataAdapter();  
   myDataAdapter.SelectCommand = new OracleCommand(mySelectQuery, myConn);  
   OracleCommandBuilder cb = new OracleCommandBuilder(myDataAdapter);  

   myConn.Open();  
   DataSet ds = new DataSet();  
   myDataAdapter.Fill(ds, myTableName);  

   //Code to modify data in DataSet goes here...  

   //Without the OracleCommandBuilder this line would fail.  
   myDataAdapter.Update(ds, myTableName);  
   myConn.Close();  
   return ds;  
}  

Comentários

Esse tipo foi preterido e será removido em uma versão futura do .NET Framework. Para obter mais informações, consulte Oracle e ADO.NET.

O OracleDataAdapter não gera automaticamente as instruções SQL necessárias para reconciliar as alterações feitas em um DataSet associado ao banco de dados. No entanto, você pode criar um OracleCommandBuilder objeto que gera instruções SQL para atualizações de tabela única definindo a SelectCommand propriedade do OracleDataAdapter. Em seguida, o OracleCommandBuilder gera quaisquer instruções SQL adicionais que você não definir.

A relação entre um OracleDataAdapter e o correspondente OracleCommandBuilder é sempre um para um. Para criar essa correspondência, defina a OracleDataAdapter propriedade do OracleCommandBuilder objeto . Isso faz com que o OracleCommandBuilder se registre como um ouvinte, o que produz a saída de RowUpdating eventos que afetam o DataSet.

Para gerar instruções INSERT, UPDATE ou DELETE, o OracleCommandBuilder usa a SelectCommand propriedade para recuperar um conjunto necessário de metadados.

O OracleCommandBuilder também usa as Connectionpropriedades e Transaction referenciadas pelo SelectCommand.

Se você chamar Dispose, o OracleCommandBuilder será desassociado do OracleDataAdaptere os comandos gerados não serão mais usados.

Construtores

OracleCommandBuilder()	Obsoleto. Inicializa uma nova instância do OracleCommandBuilder.
OracleCommandBuilder(OracleDataAdapter)	Obsoleto. Inicializa uma nova instância da classe OracleCommandBuilder com o objeto OracleDataAdapter associado.

Propriedades

CanRaiseEvents	Obsoleto. Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
CatalogLocation	Obsoleto. Obtém ou define o CatalogLocation para uma instância da classe DbCommandBuilder.
CatalogSeparator	Obsoleto. Obtém ou define uma cadeia de caracteres usada como o separador de catálogo para uma instância da classe DbCommandBuilder.
ConflictOption	Obsoleto. Especifica qual ConflictOption deve ser usado pelo DbCommandBuilder. (Herdado de DbCommandBuilder)
Container	Obsoleto. Obtém o IContainer que contém o Component. (Herdado de Component)
DataAdapter	Obsoleto. Obtém ou define um objeto OracleDataAdapter para o qual o objeto OracleCommandBuilder gerará instruções SQL.
DesignMode	Obsoleto. Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Events	Obsoleto. Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
QuotePrefix	Obsoleto. 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. (Herdado de DbCommandBuilder)
QuoteSuffix	Obsoleto. 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. (Herdado de DbCommandBuilder)
SchemaSeparator	Obsoleto. Obtém ou define o caractere a ser usado para o separador entre o identificador do esquema e de quaisquer outros identificadores.
SetAllValues	Obsoleto. Especifica se todos os valores de coluna em uma declaração de atualização são incluídos ou apenas aqueles alterados. (Herdado de DbCommandBuilder)
Site	Obsoleto. Obtém ou define o ISite do Component. (Herdado de Component)

Métodos

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Obsoleto. Permite a implementação de provedor da classe DbCommandBuilder para manipular propriedades de parâmetro adicionais. (Herdado de DbCommandBuilder)
CreateObjRef(Type)	Obsoleto. 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(OracleCommand)	Obsoleto. Recupera informações de parâmetro do procedimento armazenado especificado no OracleCommand e popula a coleção Parameters do objeto OracleCommand especificado.
Dispose()	Obsoleto. Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Obsoleto. Libera os recursos não gerenciados usados pelo DbCommandBuilder e opcionalmente libera os recursos gerenciados. (Herdado de DbCommandBuilder)
Equals(Object)	Obsoleto. Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetDeleteCommand()	Obsoleto. Obtém o objeto OracleCommand gerado automaticamente necessário para executar exclusões no banco de dados.
GetDeleteCommand(Boolean)	Obsoleto. Obtém o objeto OracleCommand gerado automaticamente necessário para executar exclusões no banco de dados.
GetHashCode()	Obsoleto. Serve como a função de hash padrão. (Herdado de Object)
GetInsertCommand()	Obsoleto. Obtém o objeto OracleCommand gerado automaticamente necessário para executar inserções no banco de dados.
GetInsertCommand(Boolean)	Obsoleto. Obtém o objeto OracleCommand gerado automaticamente necessário para executar inserções no banco de dados.
GetLifetimeService()	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)	Obsoleto. Retorna o nome do parâmetro especificado no formato de @p#. Use quando estiver criando um construtor de comando personalizado. (Herdado de DbCommandBuilder)
GetParameterName(String)	Obsoleto. Retorna o nome completo do parâmetro, considerando o nome parcial do parâmetro. (Herdado de DbCommandBuilder)
GetParameterPlaceholder(Int32)	Obsoleto. Retorna o espaço reservado para o parâmetro na instrução SQL associada. (Herdado de DbCommandBuilder)
GetSchemaTable(DbCommand)	Obsoleto. Retorna a tabela de esquema para o DbCommandBuilder. (Herdado de DbCommandBuilder)
GetService(Type)	Obsoleto. Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obsoleto. Obtém o Type da instância atual. (Herdado de Object)
GetUpdateCommand()	Obsoleto. Obtém o objeto OracleCommand gerado automaticamente necessário para realizar atualizações no banco de dados.
GetUpdateCommand(Boolean)	Obsoleto. Obtém o objeto OracleCommand gerado automaticamente necessário para realizar atualizações no banco de dados.
InitializeCommand(DbCommand)	Obsoleto. Redefine as propriedades CommandTimeout, Transaction, CommandType e UpdateRowSource no DbCommand. (Herdado de DbCommandBuilder)
InitializeLifetimeService()	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()	Obsoleto. Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Obsoleto. Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
QuoteIdentifier(String)	Obsoleto. 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()	Obsoleto. Limpa os comandos associados a este DbCommandBuilder. (Herdado de DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Obsoleto. Adiciona um manipulador de eventos para o evento RowUpdating. (Herdado de DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	Obsoleto. Registra o DbCommandBuilder para lidar com o evento RowUpdating para um DbDataAdapter. (Herdado de DbCommandBuilder)
ToString()	Obsoleto. 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)	Obsoleto. 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

Obsoleto. Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)

Confira também

• Gerando comandos com CommandBuilders