OracleCommand Classe

Definizione

Avviso

Questa API è ora obsoleta.

Rappresenta un'istruzione SQL o una stored procedure da eseguire su un database.Represents an SQL statement or stored procedure to execute against a database. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class OracleCommand sealed : 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 DbCommand
    interface ICloneable
Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable
Ereditarietà
Attributi
Implementazioni

Esempi

Nell'esempio seguente viene utilizzato il metodo ExecuteReader di OracleCommand, insieme a OracleDataReader e OracleConnection, per selezionare le righe di una tabella.The following example uses the ExecuteReader method of OracleCommand, along with OracleDataReader and OracleConnection, to select rows from a table.

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 del .NET Framework.This type is deprecated and will be removed in a future version of the .NET Framework. Per ulteriori informazioni, vedere Oracle e ADO.NET.For more information, see Oracle and ADO.NET.

La classe OracleCommand fornisce i metodi seguenti per l'esecuzione di comandi su un'origine dati:The OracleCommand class provides the following methods for executing commands against a data source:

ElementoItem DescrizioneDescription
ExecuteReader Esegue i comandi che restituiscono righe.Executes commands that return rows.
ExecuteOracleNonQuery Esegue un'istruzione SQL nella proprietà Connection e restituisce il numero di righe modificate.Executes an SQL statement against the Connection and returns the number of rows affected.
ExecuteNonQuery Esegue comandi come istruzioni SQL INSERT, DELETE, UPDATE e SET.Executes commands such as SQL INSERT, DELETE, UPDATE, and SET statements.
ExecuteScalar Recupera un singolo valore, ad esempio un valore di aggregazione, da un database come tipo di dati .NET Framework.Retrieves a single value (for example, an aggregate value) from a database as a .NET Framework data type.
ExecuteOracleScalar Recupera un singolo valore, ad esempio un valore di aggregazione, da un database come tipo di dati specifico di Oracle.Retrieves a single value (for example, an aggregate value) from a database as an Oracle-specific data type.

È possibile reimpostare la proprietà CommandText e riutilizzare l'oggetto OracleCommand.You can reset the CommandText property and reuse the OracleCommand object.

Se l'esecuzione del comando restituisce un OracleExceptionirreversibile, è possibile che il OracleConnection venga chiuso.If execution of the command results in a fatal OracleException, the OracleConnection may close. L'utente può tuttavia riaprire la connessione e continuare.However, the user can reopen the connection and continue.

Nota

Diversamente dall'oggetto Command negli altri provider di dati .NET Framework (SQL Server, OLE DB e ODBC), l'oggetto OracleCommand non supporta una proprietà CommandTimeout.Unlike the Command object in the other .NET Framework data providers (SQL Server, OLE DB, and ODBC), the OracleCommand object does not support a CommandTimeout property. L'impostazione di un timeout del comando non ha alcun effetto e il valore restituito è sempre zero.Setting a command timeout has no effect and the value returned is always zero.

Costruttori

OracleCommand()

Inizializza una nuova istanza di OracleCommand.Initializes a new instance of the OracleCommand.

OracleCommand(String)

Inizializza una nuova istanza della classe OracleCommand con il testo della query.Initializes a new instance of the OracleCommand class with the text of the query.

OracleCommand(String, OracleConnection)

Inizializza una nuova istanza della classe OracleCommand con il testo della query e un oggetto OracleConnection.Initializes a new instance of the OracleCommand class with the text of the query and an OracleConnection object.

OracleCommand(String, OracleConnection, OracleTransaction)

Consente di inizializzare una nuova istanza della classe OracleCommand con il testo della query, un oggetto OracleConnection e un oggetto OracleTransaction.Initializes a new instance of the OracleCommand class with the text of the query, an OracleConnection object, and an OracleTransaction.

Proprietà

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Ereditato da Component)
CommandText

Ottiene o imposta l'istruzione SQL o la stored procedure da eseguire in relazione al database.Gets or sets the SQL statement or stored procedure to execute against the database.

CommandTimeout

Ottiene o imposta il tempo di attesa (in secondi) prima di terminare il tentativo di eseguire un comando e generare un errore.Gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.

CommandType

Ottiene o imposta un valore che indica come viene interpretata la proprietà CommandText.Gets or sets a value indicating how the CommandText property is interpreted.

Connection

Ottiene o imposta l'oggetto OracleConnection usato da questa istanza dell'oggetto OracleCommand.Gets or sets the OracleConnection used by this instance of the OracleCommand.

Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
DbConnection

In caso di override in una classe derivata, ottiene o imposta la DbConnection usata da questo DbCommand.When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

(Ereditato da DbCommand)
DbParameterCollection

In caso di override in una classe derivata, ottiene la raccolta di oggetti DbParameter.When overridden in a derived class, gets the collection of DbParameter objects.

(Ereditato da DbCommand)
DbTransaction

In caso di override in una classe derivata, ottiene o imposta la DbTransaction all'interno della quale viene eseguito questo oggetto DbCommand.When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

(Ereditato da DbCommand)
DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Ereditato da Component)
DesignTimeVisible

Ottiene o imposta un valore che indica se l'oggetto comando deve essere visibile in un controllo di interfaccia personalizzato.Gets or sets a value indicating whether the command object should be visible in a customized interface control.

Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Ereditato da Component)
Parameters

Ottiene l'oggetto OracleParameterCollection.Gets the OracleParameterCollection.

Site

Ottiene o imposta l'oggetto ISite dell'oggetto Component.Gets or sets the ISite of the Component.

(Ereditato da Component)
Transaction

Ottiene o imposta l'oggetto OracleTransaction in cui viene eseguito OracleCommand.Gets or sets the OracleTransaction within which the OracleCommand executes.

UpdatedRowSource

Ottiene o imposta un valore che specifica in quale modo il metodo Update applicherà i risultati del comando a DataRow.Gets or sets a value that specifies how the Update method should apply command results to the DataRow.

Metodi

Cancel()

Tenta di annullare l'esecuzione di un oggetto OracleCommand.Attempts to cancel the execution of an OracleCommand.

Clone()

Crea una copia dell'oggetto OracleCommand.Creates a copy of this OracleCommand object.

CreateDbParameter()

In caso di override in una classe derivata, crea una nuova istanza di un oggetto DbParameter.When overridden in a derived class, creates a new instance of a DbParameter object.

(Ereditato da DbCommand)
CreateObjRef(Type)

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

(Ereditato da MarshalByRefObject)
CreateParameter()

Crea una nuova istanza di un oggetto OracleParameter.Creates a new instance of an OracleParameter object.

Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e facoltativamente rilascia le risorse gestite.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Ereditato da Component)
DisposeAsync()

Elimina in modo asincrono l'oggetto comando.Asynchronously diposes the command object.

(Ereditato da DbCommand)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
ExecuteDbDataReader(CommandBehavior)

In caso di override in una classe derivata, esegue il testo del comando sulla connessione.When overridden in a derived class, executes the command text against the connection.

(Ereditato da DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

I provider devono implementare questo metodo per fornire un'implementazione non predefinita per gli overload di ExecuteReader .Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

L'implementazione predefinita richiama il metodo sincrono ExecuteReader() e restituisce un'attività completata, bloccando il thread chiamante.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. L'implementazione predefinita restituirà un'attività annullata se viene passato un token di annullamento già annullato.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Le eccezioni generate da ExecuteReader verranno passate mediante la proprietà Task Exception restituita.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Questo metodo accetta un token di annullamento che può essere utilizzato per richiedere che l'operazione venga annullata in anticipo.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Le implementazioni possono ignorare la richiesta.Implementations may ignore this request.

(Ereditato da DbCommand)
ExecuteNonQuery()

Esegue un'istruzione SQL nella proprietà Connection e restituisce il numero di righe modificate.Executes an SQL statement against the Connection and returns the number of rows affected.

ExecuteNonQueryAsync()

Versione asincrona di ExecuteNonQuery(), che esegue un'istruzione SQL a fronte di un oggetto di connessione.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

Richiama ExecuteNonQueryAsync(CancellationToken) con CancellationToken.None.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

(Ereditato da DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Si tratta della versione asincrona di ExecuteNonQuery().This is the asynchronous version of ExecuteNonQuery(). I provider devono eseguire l'override con un'implementazione appropriata.Providers should override with an appropriate implementation. Il token di annullamento può facoltativamente essere ignorato.The cancellation token may optionally be ignored.

L'implementazione predefinita richiama il metodo sincrono ExecuteNonQuery() e restituisce un'attività completata, bloccando il thread chiamante.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. L'implementazione predefinita restituirà un'attività annullata se viene passato un token di annullamento già annullato.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Le eccezioni generate da ExecuteNonQuery() verranno passate mediante la proprietà Task Exception restituita.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Non richiamare altri metodi e proprietà dell'oggetto DbCommand finché l'attività restituita non viene completata.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Ereditato da DbCommand)
ExecuteOracleNonQuery(OracleString)

Esegue un'istruzione SQL nella proprietà Connection e restituisce il numero di righe modificate.Executes an SQL statement against the Connection and returns the number of rows affected.

ExecuteOracleScalar()

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.Executes the query, and returns the first column of the first row in the result set returned by the query as an Oracle-specific data type. Le colonne o le righe aggiuntive vengono ignorate.Extra columns or rows are ignored.

ExecuteReader()

Invia CommandText a Connection e compila un oggetto OracleDataReader.Sends the CommandText to the Connection and builds an OracleDataReader.

ExecuteReader(CommandBehavior)

Invia la proprietà CommandText alla proprietà Connection e compila una classe OracleDataReader mediante uno dei valori di CommandBehavior.Sends the CommandText to the Connection, and builds an OracleDataReader using one of the CommandBehavior values.

ExecuteReaderAsync()

Versione asincrona di ExecuteReader, che esegue CommandText in un Connection e restituisce un DbDataReaderAn asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) con CancellationToken.None.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

(Ereditato da DbCommand)
ExecuteReaderAsync(CancellationToken)

Versione asincrona di ExecuteReader, che esegue CommandText in un Connection e restituisce un DbDataReaderAn asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Questo metodo propaga la notifica di richiesta di annullamento delle operazioni.This method propagates a notification that operations should be canceled.

Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ereditato da DbCommand)
ExecuteReaderAsync(CommandBehavior)

Versione asincrona di ExecuteReader, che esegue CommandText in un Connection e restituisce un DbDataReaderAn asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ereditato da DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ereditato da DbCommand)
ExecuteScalar()

Esegue la query e restituisce la prima colonna della prima riga nel gruppo di risultati restituito dalla query come tipo di dati .NET Framework.Executes the query, and returns the first column of the first row in the result set returned by the query as a .NET Framework data type. Le colonne o le righe aggiuntive vengono ignorate.Extra columns or rows are ignored.

ExecuteScalarAsync()

Una versione asincrona di ExecuteScalar() che esegue la query e restituisce la prima colonna della prima riga nel set di risultati restituito dalla query.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Tutte le altre righe e colonne vengono ignorate.All other columns and rows are ignored.

Richiama ExecuteScalarAsync(CancellationToken) con CancellationToken.None.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

(Ereditato da DbCommand)
ExecuteScalarAsync(CancellationToken)

Si tratta della versione asincrona di ExecuteScalar().This is the asynchronous version of ExecuteScalar(). I provider devono eseguire l'override con un'implementazione appropriata.Providers should override with an appropriate implementation. Il token di annullamento può facoltativamente essere ignorato.The cancellation token may optionally be ignored.

L'implementazione predefinita richiama il metodo sincrono ExecuteScalar() e restituisce un'attività completata, bloccando il thread chiamante.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. L'implementazione predefinita restituirà un'attività annullata se viene passato un token di annullamento già annullato.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Le eccezioni generate da ExecuteScalar verranno passate mediante la proprietà Task Exception restituita.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Non richiamare altri metodi e proprietà dell'oggetto DbCommand finché l'attività restituita non viene completata.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Ereditato da DbCommand)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
Prepare()

Crea una versione preparata o compilata del comando sull'origine dati.Creates a prepared (or compiled) version of the command at the data source.

PrepareAsync(CancellationToken)

Crea una versione preparata (o compilata) del comando nell'origine dati in modo asincrono.Asynchronously creates a prepared (or compiled) version of the command on the data source.

(Ereditato da DbCommand)
ResetCommandTimeout()

Reimposta la proprietà CommandTimeout sul valore predefinito.Resets the CommandTimeout property to the default value.

ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Ereditato da Component)

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Ereditato da Component)

Implementazioni dell'interfaccia esplicita

IDbCommand.Connection

Ottiene o imposta l'oggetto IDbConnection usato da questa istanza dell'oggetto IDbCommand.Gets or sets the IDbConnection used by this instance of the IDbCommand.

(Ereditato da DbCommand)
IDbCommand.CreateParameter()

Crea una nuova istanza di un oggetto IDbDataParameter.Creates a new instance of an IDbDataParameter object.

IDbCommand.ExecuteReader()

Esegue la proprietà CommandText su Connection e compila IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader(CommandBehavior)

Esegue l'oggetto CommandText su Connection e compila un oggetto IDataReader utilizzando uno dei valori di CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader by using one of the CommandBehavior values.

IDbCommand.Parameters

Ottiene l'oggetto IDataParameterCollection.Gets the IDataParameterCollection.

(Ereditato da DbCommand)
IDbCommand.Transaction

Ottiene o imposta la proprietà DbTransaction in cui viene eseguito questo oggetto DbCommand.Gets or sets the DbTransaction within which this DbCommand object executes.

(Ereditato da DbCommand)

Si applica a

Vedi anche