OracleCommandBuilder Classe

Definição

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.Automatically generates single-table commands used to reconcile changes made to a DataSet with the associated database. Essa classe não pode ser herdada.This class cannot be inherited.

public ref class OracleCommandBuilder sealed : System::ComponentModel::Component
public ref class OracleCommandBuilder sealed : System::Data::Common::DbCommandBuilder
public sealed class OracleCommandBuilder : System.ComponentModel.Component
public sealed class OracleCommandBuilder : 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
type OracleCommandBuilder = class
    inherit Component
type OracleCommandBuilder = class
    inherit 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 Component
Public NotInheritable Class OracleCommandBuilder
Inherits DbCommandBuilder
Herança
OracleCommandBuilder
Herança
Atributos

Exemplos

O exemplo a seguir usa OracleCommand , juntamente com OracleDataAdapter e OracleConnection , para selecionar linhas de um banco de dados.The following example uses OracleCommand, along with OracleDataAdapter and OracleConnection, to select rows from a database. O exemplo é passado como inicializado 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 banco de dados.The example is passed an initialized DataSet, a connection string, a query string that is an SQL SELECT statement, and a string that is the name of the database table. Em seguida, o exemplo cria um OracleCommandBuilder .The example then creates an 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.This type is deprecated and will be removed in a future version of the .NET Framework. Para obter mais informações, consulte Oracle e ADO.net.For more information, see Oracle and 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.The OracleDataAdapter does not automatically generate the SQL statements required to reconcile changes made to a DataSet associated with the database. 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 .However, you can create an OracleCommandBuilder object that generates SQL statements for single-table updates by setting the SelectCommand property of the OracleDataAdapter. Em seguida, o OracleCommandBuilder gera quaisquer instruções SQL adicionais que você não definir.Then, the OracleCommandBuilder generates any additional SQL statements that you do not set.

A relação entre um OracleDataAdapter e seu correspondente OracleCommandBuilder é sempre um-para-um.The relationship between an OracleDataAdapter and its corresponding OracleCommandBuilder is always one-to-one. Para criar essa correspondência, você define a OracleDataAdapter Propriedade do OracleCommandBuilder objeto.To create this correspondence, you set the OracleDataAdapter property of the OracleCommandBuilder object. Isso faz com que o OracleCommandBuilder Registre-se como um ouvinte, que produz a saída de RowUpdating eventos que afetam o DataSet .This causes the OracleCommandBuilder to register itself as a listener, which produces the output of RowUpdating events that affect the DataSet.

Para gerar instruções INSERT, UPDATE ou DELETE, o OracleCommandBuilder usa a SelectCommand propriedade para recuperar um conjunto de metadados necessário.To generate INSERT, UPDATE, or DELETE statements, the OracleCommandBuilder uses the SelectCommand property to retrieve a required set of metadata.

O OracleCommandBuilder também usa as Connection Propriedades e Transaction referenciadas pelo SelectCommand .The OracleCommandBuilder also uses the Connection, and Transaction properties referenced by the SelectCommand.

Se você chamar Dispose , o OracleCommandBuilder será desassociado do OracleDataAdapter , e os comandos gerados não serão mais usados.If you call Dispose, the OracleCommandBuilder is disassociated from the OracleDataAdapter, and the generated commands are no longer used.

Construtores

OracleCommandBuilder()

Inicializa uma nova instância do OracleCommandBuilder.Initializes a new instance of the OracleCommandBuilder.

OracleCommandBuilder(OracleDataAdapter)

Inicializa uma nova instância da classe OracleCommandBuilder com o objeto OracleDataAdapter associado.Initializes a new instance of the OracleCommandBuilder class with the associated OracleDataAdapter object.

Propriedades

CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Herdado de Component)
CatalogLocation

Obtém ou define o CatalogLocation para uma instância da classe DbCommandBuilder.Gets or sets the CatalogLocation for an instance of the DbCommandBuilder class.

CatalogSeparator

Obtém ou define uma cadeia de caracteres usada como o separador de catálogo para uma instância da classe DbCommandBuilder.Gets or sets a string used as the catalog separator for an instance of the DbCommandBuilder class.

ConflictOption

Especifica qual ConflictOption deve ser usado pelo DbCommandBuilder.Specifies which ConflictOption is to be used by the DbCommandBuilder.

(Herdado de DbCommandBuilder)
Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Herdado de Component)
DataAdapter

Obtém ou define um objeto OracleDataAdapter para o qual o objeto OracleCommandBuilder gerará instruções SQL.Gets or sets an OracleDataAdapter object for which this OracleCommandBuilder object will generate SQL statements.

DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Herdado de Component)
Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this 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.Gets or sets the beginning character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

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.Gets or sets the beginning character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

(Herdado de DbCommandBuilder)
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.Gets or sets the ending character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

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.Gets or sets the ending character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

(Herdado de DbCommandBuilder)
SchemaSeparator

Obtém ou define o caractere a ser usado para o separador entre o identificador do esquema e de quaisquer outros identificadores.Gets or sets the character to be used for the separator between the schema identifier and any other identifiers.

SetAllValues

Especifica se todos os valores de coluna em uma declaração de atualização são incluídos ou apenas aqueles alterados.Specifies whether all column values in an update statement are included or only changed ones.

(Herdado de DbCommandBuilder)
Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the 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.Allows the provider implementation of the DbCommandBuilder class to handle additional parameter properties.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
DeriveParameters(OracleCommand)

Recupera informações de parâmetro do procedimento armazenado especificado no OracleCommand e popula a coleção Parameters do objeto OracleCommand especificado.Retrieves parameter information from the stored procedure specified in the OracleCommand and populates the Parameters collection of the specified OracleCommand object.

Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Herdado de Component)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Herdado de Component)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo DbCommandBuilder e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the DbCommandBuilder and optionally releases the managed resources.

(Herdado de DbCommandBuilder)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetDeleteCommand()

Obtém o objeto OracleCommand gerado automaticamente necessário para executar exclusões no banco de dados.Gets the automatically generated OracleCommand object required to perform deletions on the database.

GetDeleteCommand(Boolean)

Obtém o objeto OracleCommand gerado automaticamente necessário para executar exclusões no banco de dados.Gets the automatically generated OracleCommand object required to perform deletions on the database.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetInsertCommand()

Obtém o objeto OracleCommand gerado automaticamente necessário para executar inserções no banco de dados.Gets the automatically generated OracleCommand object required to perform insertions on the database.

GetInsertCommand(Boolean)

Obtém o objeto OracleCommand gerado automaticamente necessário para executar inserções no banco de dados.Gets the automatically generated OracleCommand object required to perform insertions on the database.

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
GetParameterName(Int32)

Retorna o nome do parâmetro especificado no formato de @p#.Returns the name of the specified parameter in the format of @p#. Use quando estiver criando um construtor de comando personalizado.Use when building a custom command builder.

(Herdado de DbCommandBuilder)
GetParameterName(String)

Retorna o nome completo do parâmetro, considerando o nome parcial do parâmetro.Returns the full parameter name, given the partial parameter name.

(Herdado de DbCommandBuilder)
GetParameterPlaceholder(Int32)

Retorna o espaço reservado para o parâmetro na instrução SQL associada.Returns the placeholder for the parameter in the associated SQL statement.

(Herdado de DbCommandBuilder)
GetSchemaTable(DbCommand)

Retorna a tabela de esquema para o DbCommandBuilder.Returns the schema table for the DbCommandBuilder.

(Herdado de DbCommandBuilder)
GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Herdado de Component)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetUpdateCommand()

Obtém o objeto OracleCommand gerado automaticamente necessário para realizar atualizações no banco de dados.Gets the automatically generated OracleCommand object required to perform updates on the database.

GetUpdateCommand(Boolean)

Obtém o objeto OracleCommand gerado automaticamente necessário para realizar atualizações no banco de dados.Gets the automatically generated OracleCommand object required to perform updates on the database.

InitializeCommand(DbCommand)

Redefine as propriedades CommandTimeout, Transaction, CommandType e UpdateRowSource no DbCommand.Resets the CommandTimeout, Transaction, CommandType, and UpdateRowSource properties on the 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 para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(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.Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier, including properly escaping any embedded quotes in the identifier.

RefreshSchema()

Limpa os comandos associados a este DbCommandBuilder.Clears the commands that are associated with this DbCommandBuilder.

RefreshSchema()

Limpa os comandos associados a este DbCommandBuilder.Clears the commands associated with this DbCommandBuilder.

(Herdado de DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)

Adiciona um manipulador de eventos para o evento RowUpdating.Adds an event handler for the RowUpdating event.

(Herdado de DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)

Registra o DbCommandBuilder para lidar com o evento RowUpdating para um DbDataAdapter.Registers the DbCommandBuilder to handle the RowUpdating event for a DbDataAdapter.

(Herdado de DbCommandBuilder)
ToString()

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

(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.Given a quoted identifier, returns the correct unquoted form of that identifier, including properly un-escaping any embedded quotes in the identifier.

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada ao método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Herdado de Component)

Aplica-se a