OracleCommand Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Attenzione
OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260
Rappresenta un'istruzione SQL o una stored procedure da eseguire su un database. Questa classe non può essere ereditata.
public ref class OracleCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommandpublic ref class OracleCommand sealed : System::Data::Common::DbCommand, ICloneablepublic sealed class OracleCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommandpublic sealed class OracleCommand : System.Data.Common.DbCommand, ICloneable[System.Obsolete("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleCommand : System.Data.Common.DbCommand, ICloneabletype OracleCommand = class
inherit Component
interface ICloneable
interface IDbCommand
interface IDisposabletype OracleCommand = class
inherit DbCommand
interface ICloneable[<System.Obsolete("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleCommand = class
inherit DbCommand
interface ICloneablePublic NotInheritable Class OracleCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposablePublic NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable- Ereditarietà
- Ereditarietà
- Attributi
- Implementazioni
Commenti
Questo tipo è deprecato e verrà rimosso in una versione futura di .NET Framework. Per altre informazioni, vedere Oracle e ADO.NET.
La OracleCommand classe fornisce i metodi seguenti per l'esecuzione di comandi su un'origine dati:
| Elemento | Descrizione |
|---|---|
| ExecuteReader | Esegue i comandi che restituiscono righe. |
| ExecuteOracleNonQuery | Esegue un'istruzione SQL su Connection e restituisce il numero di righe interessate. |
| ExecuteNonQuery | Esegue comandi come istruzioni SQL INSERT, DELETE, UPDATE e SET. |
| ExecuteScalar | Recupera un singolo valore (ad esempio, un valore aggregato) da un database come tipo di dati .NET Framework. |
| ExecuteOracleScalar | Recupera un singolo valore , ad esempio un valore di aggregazione, da un database come tipo di dati specifico di Oracle. |
È possibile reimpostare la CommandText proprietà e riutilizzare l'oggetto OracleCommand .
Se l'esecuzione del comando genera un errore irreversibile OracleException, l'oggetto OracleConnection potrebbe chiudersi. Tuttavia, l'utente può riaprire la connessione e continuare.
Annotazioni
A differenza dell'oggetto Command negli altri provider di dati .NET Framework (SQL Server, OLE DB e ODBC), l'oggetto OracleCommand non supporta una CommandTimeout proprietà. L'impostazione di un timeout del comando non ha alcun effetto e il valore restituito è sempre zero.
Costruttori
| Nome | Descrizione |
|---|---|
| OracleCommand() |
Obsoleti.
Inizializza una nuova istanza di OracleCommand. |
| OracleCommand(String, OracleConnection, OracleTransaction) |
Obsoleti.
Inizializza una nuova istanza della OracleCommand classe con il testo della query, un OracleConnection oggetto e un oggetto OracleTransaction. |
| OracleCommand(String, OracleConnection) |
Obsoleti.
Inizializza una nuova istanza della OracleCommand classe con il testo della query e un OracleConnection oggetto . |
| OracleCommand(String) |
Obsoleti.
Inizializza una nuova istanza della OracleCommand classe con il testo della query. |
Proprietà
| Nome | Descrizione |
|---|---|
| CanRaiseEvents |
Obsoleti.
Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component) |
| CommandText |
Obsoleti.
Ottiene o imposta l'istruzione SQL o la stored procedure da eseguire sul database. |
| CommandTimeout |
Obsoleti.
Ottiene o imposta il tempo di attesa , espresso in secondi, prima di terminare il tentativo di eseguire un comando e generare un errore. |
| CommandType |
Obsoleti.
Ottiene o imposta un valore che indica come viene interpretata la CommandText proprietà. |
| Connection |
Obsoleti.
Ottiene o imposta l'oggetto OracleConnection utilizzato da questa istanza di OracleCommand. |
| Container |
Obsoleti.
Ottiene l'oggetto IContainer contenente l'oggetto Component. (Ereditato da Component) |
| DbConnection |
Obsoleti.
Ottiene o imposta l'oggetto DbConnection utilizzato da questo DbCommandoggetto . (Ereditato da DbCommand) |
| DbParameterCollection |
Obsoleti.
Ottiene la raccolta di DbParameter oggetti . (Ereditato da DbCommand) |
| DbTransaction |
Obsoleti.
Ottiene o imposta l'oggetto all'interno del quale viene eseguito l'oggetto DbTransactionDbCommand . (Ereditato da DbCommand) |
| DesignMode |
Obsoleti.
Ottiene un valore che indica se è Component attualmente in modalità progettazione. (Ereditato da Component) |
| DesignTimeVisible |
Obsoleti.
Ottiene o imposta un valore che indica se l'oggetto comando deve essere visibile in un controllo interfaccia personalizzato. |
| Events |
Obsoleti.
Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto . (Ereditato da Component) |
| Parameters |
Obsoleti.
Ottiene l'oggetto OracleParameterCollection. |
| Site |
Obsoleti.
Ottiene o imposta l'oggetto ISite dell'oggetto Component. (Ereditato da Component) |
| Transaction |
Obsoleti.
Ottiene o imposta l'oggetto all'interno del OracleTransaction quale viene eseguito l'oggetto OracleCommand . |
| UpdatedRowSource |
Obsoleti.
Ottiene o imposta un valore che specifica come il |
Metodi
| Nome | Descrizione |
|---|---|
| Cancel() |
Obsoleti.
Tenta di annullare l'esecuzione di un oggetto OracleCommand. |
| Clone() |
Obsoleti.
Crea una copia di questo OracleCommand oggetto. |
| CreateDbParameter() |
Obsoleti.
Crea una nuova istanza di un DbParameter oggetto . (Ereditato da DbCommand) |
| CreateObjRef(Type) |
Obsoleti.
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject) |
| CreateParameter() |
Obsoleti.
Crea una nuova istanza di un OracleParameter oggetto . |
| Dispose() |
Obsoleti.
Rilascia tutte le risorse usate da Component. (Ereditato da Component) |
| Dispose(Boolean) |
Obsoleti.
Rilascia le risorse non gestite usate da Component e, facoltativamente, rilascia le risorse gestite. (Ereditato da Component) |
| Equals(Object) |
Obsoleti.
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| ExecuteDbDataReader(CommandBehavior) |
Obsoleti.
Esegue il comando sulla connessione, restituendo un DbDataReader oggetto che può essere usato per accedere ai risultati. (Ereditato da DbCommand) |
| ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) |
Obsoleti.
I provider devono implementare questo metodo per fornire un'implementazione non predefinita per ExecuteReader gli overload. L'implementazione predefinita richiama il metodo sincrono ExecuteReader() e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se è stato passato un token di annullamento già annullato. Le eccezioni generate da ExecuteReader verranno comunicate tramite la proprietà Task Exception restituita. Questo metodo accetta un token di annullamento che può essere usato per richiedere l'annullamento anticipato dell'operazione. Le implementazioni possono ignorare questa richiesta. (Ereditato da DbCommand) |
| ExecuteNonQuery() |
Obsoleti.
Esegue un'istruzione SQL su Connection e restituisce il numero di righe interessate. |
| ExecuteNonQueryAsync() |
Obsoleti.
Versione asincrona di ExecuteNonQuery(), che esegue il comando sul relativo oggetto connessione, restituendo il numero di righe interessate. ExecuteNonQueryAsync(CancellationToken) Richiama con CancellationToken.None. (Ereditato da DbCommand) |
| ExecuteNonQueryAsync(CancellationToken) |
Obsoleti.
Si tratta della versione asincrona di ExecuteNonQuery(). I provider devono eseguire l'override con un'implementazione appropriata. Facoltativamente, il token di annullamento può essere ignorato. L'implementazione predefinita richiama il metodo sincrono ExecuteNonQuery() e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se è stato passato un token di annullamento già annullato. Le eccezioni generate da ExecuteNonQuery() verranno comunicate tramite la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto |
| ExecuteOracleNonQuery(OracleString) |
Obsoleti.
Esegue un'istruzione SQL su Connection e restituisce il numero di righe interessate. |
| ExecuteOracleScalar() |
Obsoleti.
Esegue la query e restituisce la prima colonna della prima riga nel set di risultati restituito dalla query come tipo di dati specifico di Oracle. Le colonne o le righe aggiuntive vengono ignorate. |
| ExecuteReader() |
Obsoleti.
Invia all'oggetto CommandTextConnection e compila un oggetto OracleDataReader. |
| ExecuteReader(CommandBehavior) |
Obsoleti.
Invia l'oggetto ConnectionCommandText a e compila un oggetto OracleDataReader usando uno dei CommandBehavior valori . |
| ExecuteReaderAsync() |
Obsoleti.
Versione asincrona di ExecuteReader, che esegue il comando sulla relativa connessione, restituendo un DbDataReader oggetto che può essere usato per accedere ai risultati. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Richiama con CancellationToken.None. (Ereditato da DbCommand) |
| ExecuteReaderAsync(CancellationToken) |
Obsoleti.
Versione asincrona di ExecuteReader, che esegue il comando sulla relativa connessione, restituendo un DbDataReader oggetto che può essere usato per accedere ai risultati. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Richiama . (Ereditato da DbCommand) |
| ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Obsoleti.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Richiama . (Ereditato da DbCommand) |
| ExecuteReaderAsync(CommandBehavior) |
Obsoleti.
Versione asincrona di ExecuteReader, che esegue il comando sulla relativa connessione, restituendo un DbDataReader oggetto che può essere usato per accedere ai risultati. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Richiama . (Ereditato da DbCommand) |
| ExecuteScalar() |
Obsoleti.
Esegue la query e restituisce la prima colonna della prima riga nel set di risultati restituito dalla query come tipo di dati .NET. Le colonne o le righe aggiuntive vengono ignorate. |
| ExecuteScalarAsync() |
Obsoleti.
Versione asincrona di ExecuteScalar(), che esegue il comando e restituisce la prima colonna della prima riga del primo set di risultati restituito. Tutte le altre colonne, righe e set di risultati vengono ignorate. ExecuteScalarAsync(CancellationToken) Richiama con CancellationToken.None. (Ereditato da DbCommand) |
| ExecuteScalarAsync(CancellationToken) |
Obsoleti.
Si tratta della versione asincrona di ExecuteScalar(). I provider devono eseguire l'override con un'implementazione appropriata. Facoltativamente, il token di annullamento può essere ignorato. L'implementazione predefinita richiama il metodo sincrono ExecuteScalar() e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se è stato passato un token di annullamento già annullato. Le eccezioni generate da ExecuteScalar verranno comunicate tramite la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto |
| GetHashCode() |
Obsoleti.
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Obsoleti.
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| GetService(Type) |
Obsoleti.
Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container. (Ereditato da Component) |
| GetType() |
Obsoleti.
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| InitializeLifetimeService() |
Obsoleti.
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| MemberwiseClone() |
Obsoleti.
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Obsoleti.
Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| Prepare() |
Obsoleti.
Crea una versione preparata (o compilata) del comando nell'origine dati. |
| ResetCommandTimeout() |
Obsoleti.
Reimposta la CommandTimeout proprietà sul valore predefinito. |
| ToString() |
Obsoleti.
Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override. (Ereditato da Component) |
Eventi
| Nome | Descrizione |
|---|---|
| Disposed |
Obsoleti.
Si verifica quando il componente viene eliminato da una chiamata al Dispose() metodo . (Ereditato da Component) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IDbCommand.Connection |
Obsoleti.
Ottiene o imposta l'oggetto IDbConnection utilizzato da questa istanza di IDbCommand. (Ereditato da DbCommand) |
| IDbCommand.CreateParameter() |
Obsoleti.
Crea una nuova istanza di un IDbDataParameter oggetto . |
| IDbCommand.CreateParameter() |
Obsoleti.
Crea una nuova istanza di un IDbDataParameter oggetto . (Ereditato da DbCommand) |
| IDbCommand.ExecuteReader() |
Obsoleti.
Esegue l'oggetto sull'oggetto CommandTextConnection e compila un oggetto IDataReader. |
| IDbCommand.ExecuteReader() |
Obsoleti.
Esegue l'oggetto sull'oggetto CommandTextConnection e compila un oggetto IDataReader. (Ereditato da DbCommand) |
| IDbCommand.ExecuteReader(CommandBehavior) |
Obsoleti.
Esegue l'oggetto CommandTextConnectionsu e compila un IDataReader oggetto usando uno dei CommandBehavior valori . |
| IDbCommand.ExecuteReader(CommandBehavior) |
Obsoleti.
Esegue l'oggetto CommandTextConnectionsu e compila un IDataReader oggetto usando uno dei CommandBehavior valori . (Ereditato da DbCommand) |
| IDbCommand.Parameters |
Obsoleti.
Ottiene l'oggetto IDataParameterCollection. (Ereditato da DbCommand) |
| IDbCommand.Transaction |
Obsoleti.
Ottiene o imposta l'oggetto all'interno del quale viene eseguito l'oggetto DbTransactionDbCommand . (Ereditato da DbCommand) |
