OracleCommand OracleCommand OracleCommand OracleCommand Class

Definizione

Avviso

Questa API è ora obsoleta.

Rappresenta un'istruzione SQL o una stored procedure da eseguire in relazione a 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

L'esempio seguente usa il ExecuteReader metodo di OracleCommand, insieme a OracleDataReader e OracleConnection, selezionare le righe da 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à rimossa in una futura versione di .NET Framework.This type is deprecated and will be removed in a future version of the .NET Framework. Per altre informazioni, vedere Oracle e ADO.NET.For more information, see Oracle and ADO.NET.

Il OracleCommand classe 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 i comandi, ad esempio le 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 aggregato) da un database come un 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 aggregato) da un database come un tipo di dati Oracle specifico.Retrieves a single value (for example, an aggregate value) from a database as an Oracle-specific data type.

È possibile reimpostare la CommandText proprietà e il riutilizzo di OracleCommand oggetto.You can reset the CommandText property and reuse the OracleCommand object.

Se l'esecuzione del comando genera un errore irreversibile OracleException, il OracleConnection venga chiusa.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

A differenza di comando oggetto in altri provider di dati .NET Framework (SQL Server, OLE DB e ODBC), il OracleCommand objekt nepodporuje un CommandTimeout proprietà.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() OracleCommand() OracleCommand() OracleCommand()

Inizializza una nuova istanza dell'oggetto OracleCommand.Initializes a new instance of the OracleCommand.

OracleCommand(String) OracleCommand(String) OracleCommand(String) 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) OracleCommand(String, OracleConnection) OracleCommand(String, OracleConnection) 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) OracleCommand(String, OracleConnection, OracleTransaction) OracleCommand(String, OracleConnection, OracleTransaction) 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 CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
CommandText CommandText CommandText 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 CommandTimeout CommandTimeout CommandTimeout

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

CommandType CommandType CommandType 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 Connection Connection 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 Container Container Container

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

(Inherited from Component)
DesignMode DesignMode DesignMode 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.

(Inherited from Component)
DesignTimeVisible DesignTimeVisible DesignTimeVisible 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 Events Events Events

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

(Inherited from Component)
Parameters Parameters Parameters Parameters

Ottiene l'oggetto OracleParameterCollection.Gets the OracleParameterCollection.

Site Site Site Site

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

(Inherited from Component)
Transaction Transaction Transaction Transaction

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

UpdatedRowSource UpdatedRowSource UpdatedRowSource 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() Cancel() Cancel() Cancel()

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

Clone() Clone() Clone() Clone()

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
CreateParameter() CreateParameter() CreateParameter() CreateParameter()

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

Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() 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.

ExecuteOracleNonQuery(OracleString) ExecuteOracleNonQuery(OracleString) ExecuteOracleNonQuery(OracleString) 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() ExecuteOracleScalar() ExecuteOracleScalar() 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() ExecuteReader() ExecuteReader() ExecuteReader()

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

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) 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.

ExecuteScalar() ExecuteScalar() ExecuteScalar() 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.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) 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.

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
Prepare() Prepare() Prepare() 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.

ResetCommandTimeout() ResetCommandTimeout() ResetCommandTimeout() ResetCommandTimeout()

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

ToString() ToString() ToString() 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.

(Inherited from Component)

Implementazioni dell'interfaccia esplicita

IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter()

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

IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader()

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

IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) 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.

Eventi

Disposed Disposed Disposed 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.

(Inherited from Component)

Si applica a

Vedi anche