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 in relazione a un database. La classe non può essere ereditata.
public ref class OracleCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OracleCommand sealed : System::Data::Common::DbCommand, ICloneable
public sealed class OracleCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public 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, ICloneable
type OracleCommand = class
inherit Component
interface ICloneable
interface IDbCommand
interface IDisposable
type 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 ICloneable
Public NotInheritable Class OracleCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable
- Ereditarietà
- Ereditarietà
- Attributi
- Implementazioni
Esempio
Nell'esempio seguente viene usato il ExecuteReader metodo di OracleCommand, insieme OracleDataReader a e OracleConnection, per selezionare le righe da una tabella.
public void ReadMyData(string connectionString)
{
string queryString = "SELECT EmpNo, DeptNo FROM Scott.Emp";
using (OracleConnection connection = new OracleConnection(connectionString))
{
OracleCommand command = new OracleCommand(queryString, connection);
connection.Open();
OracleDataReader reader = command.ExecuteReader();
try
{
while (reader.Read())
{
Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetInt32(1));
}
}
finally
{
// always call Close when done reading.
reader.Close();
}
}
}
Public Sub ReadMyData(ByVal connectionString As String)
Dim queryString As String = "SELECT EmpNo, DeptNo FROM Scott.Emp"
Using connection As New OracleConnection(connectionString)
Dim command As New OracleCommand(queryString, connection)
connection.Open()
Dim reader As OracleDataReader = command.ExecuteReader()
Try
While reader.Read()
Console.WriteLine(reader.GetInt32(0) & ", " _
& reader.GetInt32(1))
End While
Finally
' always call Close when done reading.
reader.Close()
End Try
End Using
End Sub
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 nella proprietà Connection e restituisce il numero di righe modificate. |
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 aggregato) 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 comporta un errore irreversibile OracleException, l'oggetto OracleConnection può essere chiuso. L'utente può tuttavia riaprire la connessione e continuare.
Nota
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
OracleCommand() |
Obsoleti.
Inizializza una nuova istanza dell'oggetto OracleCommand. |
OracleCommand(String) |
Obsoleti.
Inizializza una nuova istanza della classe OracleCommand con il testo della query. |
OracleCommand(String, OracleConnection) |
Obsoleti.
Inizializza una nuova istanza della classe OracleCommand con il testo della query e un oggetto OracleConnection. |
OracleCommand(String, OracleConnection, OracleTransaction) |
Obsoleti.
Consente di inizializzare una nuova istanza della classe OracleCommand con il testo della query, un oggetto OracleConnection e un oggetto OracleTransaction. |
Proprietà
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 in relazione al database. |
CommandTimeout |
Obsoleti.
Ottiene o imposta il tempo di attesa (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 proprietà CommandText. |
Connection |
Obsoleti.
Ottiene o imposta l'oggetto OracleConnection usato da questa istanza dell'oggetto OracleCommand. |
Container |
Obsoleti.
Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component) |
DbConnection |
Obsoleti.
Ottiene o imposta l'oggetto DbConnection utilizzato da DbCommand. (Ereditato da DbCommand) |
DbParameterCollection |
Obsoleti.
Ottiene la raccolta di oggetti DbParameter. (Ereditato da DbCommand) |
DbTransaction |
Obsoleti.
Ottiene o imposta la proprietà DbTransaction in cui viene eseguito questo oggetto DbCommand. (Ereditato da DbCommand) |
DesignMode |
Obsoleti.
Ottiene un valore che indica se il Component si trova 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 di interfaccia personalizzato. |
Events |
Obsoleti.
Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component) |
Parameters |
Obsoleti.
Ottiene l'oggetto OracleParameterCollection. |
Site |
Obsoleti.
Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component) |
Transaction |
Obsoleti.
Ottiene o imposta l'oggetto OracleTransaction in cui viene eseguito OracleCommand. |
UpdatedRowSource |
Obsoleti.
Ottiene o imposta un valore che specifica in quale modo il metodo |
Metodi
Cancel() |
Obsoleti.
Tenta di annullare l'esecuzione di un oggetto OracleCommand. |
Clone() |
Obsoleti.
Crea una copia dell'oggetto OracleCommand. |
CreateDbParameter() |
Obsoleti.
Crea una nuova istanza di un oggetto DbParameter. (Ereditato da DbCommand) |
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) |
CreateParameter() |
Obsoleti.
Crea una nuova istanza di un oggetto OracleParameter . |
Dispose() |
Obsoleti.
Rilascia tutte le risorse usate da Component. (Ereditato da Component) |
Dispose() |
Obsoleti.
Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da DbCommand) |
Dispose(Boolean) |
Obsoleti.
Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite. (Ereditato da Component) |
Dispose(Boolean) |
Obsoleti.
Rilascia le risorse non gestite usate da DbCommand e, facoltativamente, le risorse gestite. (Ereditato da DbCommand) |
DisposeAsync() |
Obsoleti.
Elimina in modo asincrono l'oggetto comando. (Ereditato da DbCommand) |
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 gli overload di ExecuteReader . 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 viene passato un token di annullamento già annullato. Le eccezioni generate da ExecuteReader verranno passate mediante la proprietà Task Exception restituita. Questo metodo accetta un token di annullamento che può essere utilizzato per richiedere che l'operazione venga annullata in anticipo. Le implementazioni possono ignorare la richiesta. (Ereditato da DbCommand) |
ExecuteNonQuery() |
Obsoleti.
Esegue un'istruzione SQL nella proprietà Connection e restituisce il numero di righe modificate. |
ExecuteNonQueryAsync() |
Obsoleti.
Versione asincrona di ExecuteNonQuery(), che esegue il comando sull'oggetto di connessione, restituendo il numero di righe interessate. Richiama ExecuteNonQueryAsync(CancellationToken) 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. Il token di annullamento può facoltativamente 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 viene passato un token di annullamento già annullato. Le eccezioni generate da ExecuteNonQuery() verranno passate mediante la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto |
ExecuteOracleNonQuery(OracleString) |
Obsoleti.
Esegue un'istruzione SQL nella proprietà Connection e restituisce il numero di righe modificate. |
ExecuteOracleScalar() |
Obsoleti.
Esegue la query e restituisce la prima colonna della prima riga nel gruppo di risultati restituito dalla query come tipo di dati specifico di Oracle. Le colonne o le righe aggiuntive vengono ignorate. |
ExecuteReader() |
Obsoleti.
Invia CommandText a Connection e compila un oggetto OracleDataReader. |
ExecuteReader(CommandBehavior) |
Obsoleti.
Invia la proprietà CommandText alla proprietà Connection e compila una classe OracleDataReader mediante uno dei valori di CommandBehavior. |
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. Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) 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. Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (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. Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Ereditato da DbCommand) |
ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Obsoleti.
Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Ereditato da DbCommand) |
ExecuteScalar() |
Obsoleti.
Esegue la query e restituisce la prima colonna della prima riga nel gruppo 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 nel primo set di risultati restituito. Vengono ignorate tutte le altre colonne, righe e set di risultati. Richiama ExecuteScalarAsync(CancellationToken) 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. Il token di annullamento può facoltativamente 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 viene passato un token di annullamento già annullato. Le eccezioni generate da ExecuteScalar verranno passate mediante 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.
Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject) |
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) |
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 dell'oggetto Object corrente. (Ereditato da Object) |
MemberwiseClone(Boolean) |
Obsoleti.
Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject) |
Prepare() |
Obsoleti.
Crea una versione preparata o compilata del comando sull'origine dati. |
PrepareAsync(CancellationToken) |
Obsoleti.
Crea una versione preparata (o compilata) del comando nell'origine dati in modo asincrono. (Ereditato da DbCommand) |
ResetCommandTimeout() |
Obsoleti.
Reimposta la proprietà CommandTimeout sul valore predefinito. |
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) |
Eventi
Disposed |
Obsoleti.
Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component) |
Implementazioni dell'interfaccia esplicita
IDbCommand.Connection |
Obsoleti.
Ottiene o imposta l'oggetto IDbConnection usato da questa istanza dell'oggetto IDbCommand. (Ereditato da DbCommand) |
IDbCommand.CreateParameter() |
Obsoleti.
Crea una nuova istanza di un oggetto IDbDataParameter . |
IDbCommand.CreateParameter() |
Obsoleti.
Crea una nuova istanza di un oggetto IDbDataParameter . (Ereditato da DbCommand) |
IDbCommand.ExecuteReader() |
Obsoleti.
Esegue la proprietà CommandText su Connection e compila IDataReader. |
IDbCommand.ExecuteReader() |
Obsoleti.
Esegue la proprietà CommandText su Connection e compila IDataReader. (Ereditato da DbCommand) |
IDbCommand.ExecuteReader(CommandBehavior) |
Obsoleti.
Esegue l'oggetto CommandText su Connection e compila un oggetto IDataReader utilizzando uno dei valori di CommandBehavior. |
IDbCommand.ExecuteReader(CommandBehavior) |
Obsoleti.
Esegue la proprietà CommandText su Connection e compila IDataReader usando uno dei valori di CommandBehavior. (Ereditato da DbCommand) |
IDbCommand.Parameters |
Obsoleti.
Ottiene l'oggetto IDataParameterCollection. (Ereditato da DbCommand) |
IDbCommand.Transaction |
Obsoleti.
Ottiene o imposta la proprietà DbTransaction in cui viene eseguito questo oggetto DbCommand. (Ereditato da DbCommand) |