OracleCommandBuilder Classe

Definizione

Spazio dei nomi:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Attenzione

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

Genera automaticamente comandi di tabella singola per risolvere le modifiche apportate a un oggetto DataSet con il database associato. La classe non può essere ereditata.

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

Ereditarietà

Object

MarshalByRefObject

Component

DbCommandBuilder

OracleCommandBuilder

Attributi

ObsoleteAttribute

Esempio

L'esempio seguente usa OracleCommand, insieme OracleDataAdapter a e OracleConnection, per selezionare le righe da un database. Nell'esempio viene passato un oggetto inizializzato DataSet, un stringa di connessione, una stringa di query che è un'istruzione SQL SELECT e una stringa che corrisponde al nome della tabella di database. L'esempio crea quindi un oggetto 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;  
}  

Commenti

Questo tipo è deprecato e verrà rimosso in una versione futura di .NET Framework. Per altre informazioni, vedere Oracle e ADO.NET.

Non OracleDataAdapter genera automaticamente le istruzioni SQL necessarie per riconciliare le modifiche apportate a un DataSet oggetto associato al database. È tuttavia possibile creare un OracleCommandBuilder oggetto che genera istruzioni SQL per gli aggiornamenti a tabella singola impostando la SelectCommand proprietà di OracleDataAdapter. OracleCommandBuilder Genera quindi eventuali istruzioni SQL aggiuntive non impostate.

La relazione tra un OracleDataAdapter oggetto e il corrispondente OracleCommandBuilder è sempre uno-a-uno. Per creare questa corrispondenza, impostare la OracleDataAdapter proprietà dell'oggetto OracleCommandBuilder . In questo modo l'oggetto OracleCommandBuilder viene registrato come listener, che produce l'output degli RowUpdating eventi che influiscono su DataSet.

Per generare istruzioni INSERT, UPDATE o DELETE, OracleCommandBuilder viene utilizzata la SelectCommand proprietà per recuperare un set di metadati richiesto.

Vengono OracleCommandBuilder inoltre utilizzate le Connectionproprietà , e Transaction a cui fa riferimento l'oggetto SelectCommand.

Se si chiama Dispose, l'oggetto OracleCommandBuilder viene disassociato da OracleDataAdaptere i comandi generati non vengono più usati.

Costruttori

OracleCommandBuilder()	Obsoleti. Inizializza una nuova istanza dell'oggetto OracleCommandBuilder.
OracleCommandBuilder(OracleDataAdapter)	Obsoleti. Inizializza una nuova istanza della classe OracleCommandBuilder con l'oggetto OracleDataAdapter associato.

Proprietà

CanRaiseEvents	Obsoleti. Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
CatalogLocation	Obsoleti. Ottiene o imposta il valore CatalogLocation per un'istanza della classe DbCommandBuilder.
CatalogSeparator	Obsoleti. Ottiene o imposta una stringa usata come separatore di catalogo per un'istanza della classe DbCommandBuilder.
ConflictOption	Obsoleti. Specifica quale enumerazione ConflictOption deve essere utilizzata dalla classe DbCommandBuilder. (Ereditato da DbCommandBuilder)
Container	Obsoleti. Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
DataAdapter	Obsoleti. Ottiene o imposta un oggetto OracleDataAdapter per il quale questo oggetto OracleCommandBuilder genererà istruzioni SQL.
DesignMode	Obsoleti. Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Events	Obsoleti. Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
QuotePrefix	Obsoleti. Ottiene o imposta il carattere o i caratteri iniziali da utilizzare quando si specificano oggetti di database, ad esempio tabelle o colonne, i cui nomi contengono caratteri quali spazi o token riservati. (Ereditato da DbCommandBuilder)
QuoteSuffix	Obsoleti. Ottiene o imposta il carattere o i caratteri finali da utilizzare quando si specificano oggetti di database, ad esempio tabelle o colonne, i cui nomi contengono caratteri quali spazi o token riservati. (Ereditato da DbCommandBuilder)
SchemaSeparator	Obsoleti. Ottiene o imposta il carattere da utilizzare come separatore tra l'identificatore di schema e altri identificatori.
SetAllValues	Obsoleti. Specifica se in un'istruzione di aggiornamento sono inclusi tutti i valori delle colonne o soltanto quelli modificati. (Ereditato da DbCommandBuilder)
Site	Obsoleti. Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)

Metodi

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Obsoleti. Attiva l'implementazione del provider per la classe DbCommandBuilder per consentire la gestione di proprietà aggiuntive dei parametri. (Ereditato da DbCommandBuilder)
CreateObjRef(Type)	Obsoleti. Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
DeriveParameters(OracleCommand)	Obsoleti. Recupera le informazioni sui parametri dalla stored procedure specificata nella classe OracleCommand e compila l'insieme Parameters dell'oggetto OracleCommand specificato.
Dispose()	Obsoleti. Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Obsoleti. Rilascia le risorse non gestite usate da DbCommandBuilder e, facoltativamente, le risorse gestite. (Ereditato da DbCommandBuilder)
Equals(Object)	Obsoleti. Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetDeleteCommand()	Obsoleti. Ottiene l'oggetto OracleCommand generato automaticamente, richiesto per eseguire le operazioni di eliminazione nel database.
GetDeleteCommand(Boolean)	Obsoleti. Ottiene l'oggetto OracleCommand generato automaticamente, richiesto per eseguire le operazioni di eliminazione nel database.
GetHashCode()	Obsoleti. Funge da funzione hash predefinita. (Ereditato da Object)
GetInsertCommand()	Obsoleti. Ottiene l'oggetto OracleCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nel database.
GetInsertCommand(Boolean)	Obsoleti. Ottiene l'oggetto OracleCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nel database.
GetLifetimeService()	Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetParameterName(Int32)	Obsoleti. Restituisce il nome del parametro specificato nel formato .@p# Da utilizzare quando si compila un generatore di comandi personalizzato. (Ereditato da DbCommandBuilder)
GetParameterName(String)	Obsoleti. Restituisce il nome completo del parametro, dato il suo nome parziale. (Ereditato da DbCommandBuilder)
GetParameterPlaceholder(Int32)	Obsoleti. Restituisce il segnaposto del parametro nell'istruzione SQL associata. (Ereditato da DbCommandBuilder)
GetSchemaTable(DbCommand)	Obsoleti. Restituisce la tabella dello schema della classe DbCommandBuilder. (Ereditato da DbCommandBuilder)
GetService(Type)	Obsoleti. Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Obsoleti. Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetUpdateCommand()	Obsoleti. Ottiene l'oggetto OracleCommand generato automaticamente, richiesto per eseguire le operazioni di aggiornamento nel database.
GetUpdateCommand(Boolean)	Obsoleti. Ottiene l'oggetto OracleCommand generato automaticamente, richiesto per eseguire le operazioni di aggiornamento nel database.
InitializeCommand(DbCommand)	Obsoleti. Reimposta le proprietà CommandTimeout, Transaction, CommandType e UpdateRowSource sul valore DbCommand. (Ereditato da DbCommandBuilder)
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Obsoleti. Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Obsoleti. Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
QuoteIdentifier(String)	Obsoleti. Specificato un identificatore senza virgolette nel caso di catalogo corretto, viene restituito il formato corretto tra virgolette di quell'identificatore, incluso l'escape corretto di tutte le virgolette incorporate nell'identificatore.
RefreshSchema()	Obsoleti. Elimina i comandi associati all'oggetto DbCommandBuilder. (Ereditato da DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Obsoleti. Aggiunge un gestore eventi per l'evento RowUpdating. (Ereditato da DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	Obsoleti. Registra l'oggetto DbCommandBuilder per gestire l'evento RowUpdating per un oggetto DbDataAdapter. (Ereditato da DbCommandBuilder)
ToString()	Obsoleti. Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)
UnquoteIdentifier(String)	Obsoleti. Specificato un identificatore con virgolette, viene restituito il formato corretto senza virgolette di quell'identificatore, incluso il corretto utilizzo di caratteri non di escape per le virgolette incorporate nell'identificatore.

Eventi

Disposed

Obsoleti. Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)

Vedi anche

• Generazione di comandi tramite CommandBuilders