OracleCommand Clase

Definición

Espacio de nombres:

System.Data.OracleClient

Ensamblado:

System.Data.OracleClient.dll

Precaución

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

Representa una instrucción SQL o un procedimiento almacenado que se va a ejecutar en una base de datos. Esta clase no puede heredarse.

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

[<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 DbCommand
Implements ICloneable

Herencia

Object

MarshalByRefObject

Component

DbCommand

OracleCommand

Atributos

ObsoleteAttribute

Implementaciones

ICloneable

Ejemplos

En el ejemplo siguiente se usa el ExecuteReader método de OracleCommand, junto con OracleDataReader y OracleConnection, para seleccionar filas de una tabla.

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

Comentarios

Este tipo está en desuso y se quitará en una versión futura de .NET Framework. Para más información, consulte Oracle y ADO.NET.

La OracleCommand clase proporciona los métodos siguientes para ejecutar comandos en un origen de datos:

Elemento	Descripción
ExecuteReader	Ejecuta comandos que devuelven filas.
ExecuteOracleNonQuery	Ejecuta una instrucción SQL en Connection y devuelve el número de filas afectadas.
ExecuteNonQuery	Ejecuta comandos como instrucciones SQL INSERT, DELETE, UPDATE y SET.
ExecuteScalar	Recupera un valor único (por ejemplo, un valor agregado) de una base de datos como un tipo de datos de .NET Framework.
ExecuteOracleScalar	Recupera un valor único (por ejemplo, un valor agregado) de una base de datos como un tipo de datos específico de Oracle.

Puede restablecer la CommandText propiedad y reutilizar el OracleCommand objeto .

Si la ejecución del comando da como resultado un error irrecuperable OracleException, puede cerrarse OracleConnection . Sin embargo, el usuario puede volver a abrir la conexión y continuar.

Nota

A diferencia del objeto Command de los otros proveedores de datos de .NET Framework (SQL Server, OLE DB y ODBC), el OracleCommand objeto no admite una CommandTimeout propiedad . Establecer un tiempo de espera de comando no tiene ningún efecto y el valor devuelto siempre es cero.

Constructores

OracleCommand()	Obsoletos. Inicializa una nueva instancia de OracleCommand.
OracleCommand(String)	Obsoletos. Inicializa una nueva instancia de la clase OracleCommand con el texto de la consulta.
OracleCommand(String, OracleConnection)	Obsoletos. Inicializa una nueva instancia de la clase OracleCommand con el texto de la consulta y un objeto OracleConnection.
OracleCommand(String, OracleConnection, OracleTransaction)	Obsoletos. Inicializa una nueva instancia de la clase OracleCommand con el texto de la consulta, un objeto OracleConnection y un objeto OracleTransaction.

Propiedades

CanRaiseEvents	Obsoletos. Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
CommandText	Obsoletos. Obtiene o establece la instrucción SQL o el procedimiento almacenado que se va a ejecutar en la base de datos.
CommandTimeout	Obsoletos. Obtiene o establece el tiempo de espera (en segundos) hasta que se interrumpe el intento de ejecutar un comando y se genera un error.
CommandType	Obsoletos. Obtiene o establece un valor que indica cómo se interpreta la propiedad CommandText.
Connection	Obsoletos. Obtiene o establece la interfaz OracleConnection que usa esta instancia de OracleCommand.
Container	Obsoletos. Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
DbConnection	Obsoletos. Obtiene o establece el objeto DbConnection utilizado por este DbCommand. (Heredado de DbCommand)
DbParameterCollection	Obsoletos. Obtiene la colección de objetos DbParameter. (Heredado de DbCommand)
DbTransaction	Obsoletos. Obtiene o establece DbTransaction dentro del cual se ejecuta este objeto DbCommand. (Heredado de DbCommand)
DesignMode	Obsoletos. Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
DesignTimeVisible	Obsoletos. Obtiene o establece un valor que indica si el objeto de comando debe estar visible en un control de interfaz personalizado.
Events	Obsoletos. Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
Parameters	Obsoletos. Obtiene la estructura OracleParameterCollection.
Site	Obsoletos. Obtiene o establece ISite de Component. (Heredado de Component)
Transaction	Obsoletos. Obtiene o establece la transacción OracleTransaction en la que se ejecuta OracleCommand.
UpdatedRowSource	Obsoletos. Obtiene o establece un valor que especifica cómo debe aplicar el método Update los resultados de comando al objeto DataRow.

Métodos

Cancel()	Obsoletos. Intenta cancelar la ejecución de un objeto OracleCommand.
Clone()	Obsoletos. Crea una copia de este objeto OracleCommand.
CreateDbParameter()	Obsoletos. Crea una nueva instancia de un objeto DbParameter. (Heredado de DbCommand)
CreateObjRef(Type)	Obsoletos. Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
CreateParameter()	Obsoletos. Crea una nueva instancia de un objeto OracleParameter .
Dispose()	Obsoletos. Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de DbCommand)
Dispose(Boolean)	Obsoletos. Libera los recursos no administrados que usa DbCommand y, de forma opcional, libera los recursos administrados. (Heredado de DbCommand)
DisposeAsync()	Obsoletos. Desecha de forma asincrónica el objeto de comando. (Heredado de DbCommand)
Equals(Object)	Obsoletos. Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
ExecuteDbDataReader(CommandBehavior)	Obsoletos. Ejecuta el comando en su conexión, devolviendo un DbDataReader objeto que se puede usar para tener acceso a los resultados. (Heredado de DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Obsoletos. Los proveedores deben implementar este método para proporcionar una implementación no predeterminada para las sobrecargas de ExecuteReader. La implementación predeterminada invoca el método sincrónico ExecuteReader() y devuelve una tarea completada, bloqueando el subproceso de llamada. La implementación predeterminada devolverá una tarea cancelada si se pasa un token de cancelación ya cancelado. Las excepciones producidas por ExecuteReader se comunicarán mediante la propiedad Task Exception devuelta. Este método acepta un token de cancelación que se puede usar para solicitar que la operación se cancele pronto. Las implementaciones pueden omitir esta solicitud. (Heredado de DbCommand)
ExecuteNonQuery()	Obsoletos. Ejecuta una instrucción SQL en Connection y devuelve el número de filas afectadas.
ExecuteNonQueryAsync()	Obsoletos. Una versión asincrónica de ExecuteNonQuery(), que ejecuta el comando en su objeto de conexión, devolviendo el número de filas afectadas. Invoca ExecuteNonQueryAsync(CancellationToken) con CancellationToken.None. (Heredado de DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Obsoletos. Esta es la versión asincrónica de ExecuteNonQuery(). Los proveedores lo deben reemplazar con una implementación apropiada. El token de cancelación se puede omitir opcionalmente. La implementación predeterminada invoca el método sincrónico ExecuteNonQuery() y devuelve una tarea completada, bloqueando el subproceso de llamada. La implementación predeterminada devolverá una tarea cancelada si se pasa un token de cancelación ya cancelado. Las excepciones producidas por ExecuteNonQuery() se comunicarán mediante la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del objeto DbCommand hasta que se haya completado la tarea devuelta. (Heredado de DbCommand)
ExecuteOracleNonQuery(OracleString)	Obsoletos. Ejecuta una instrucción SQL en Connection y devuelve el número de filas afectadas.
ExecuteOracleScalar()	Obsoletos. Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados que devuelve la consulta como un tipo de datos específico de Oracle. Las columnas o filas adicionales no se tienen en cuenta.
ExecuteReader()	Obsoletos. Envía una propiedad CommandText a la propiedad Connection y compila un objeto OracleDataReader.
ExecuteReader(CommandBehavior)	Obsoletos. Envía CommandText a Connection y crea un objeto OracleDataReader con uno de los valores de CommandBehavior.
ExecuteReaderAsync()	Obsoletos. Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, devolviendo un DbDataReader objeto que se puede usar para acceder a los resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) con CancellationToken.None. (Heredado de DbCommand)
ExecuteReaderAsync(CancellationToken)	Obsoletos. Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, devolviendo un DbDataReader objeto que se puede usar para acceder a los resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Heredado de DbCommand)
ExecuteReaderAsync(CommandBehavior)	Obsoletos. Una versión asincrónica de ExecuteReader, que ejecuta el comando en su conexión, devolviendo un DbDataReader objeto que se puede usar para acceder a los resultados. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Heredado de DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Obsoletos. Invoca ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Heredado de DbCommand)
ExecuteScalar()	Obsoletos. Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta como un tipo de datos .NET. Las columnas o filas adicionales no se tienen en cuenta.
ExecuteScalarAsync()	Obsoletos. Una versión asincrónica de ExecuteScalar(), que ejecuta el comando y devuelve la primera columna de la primera fila del primer conjunto de resultados devuelto. Se omiten todas las demás columnas, filas y conjuntos de resultados. Invoca ExecuteScalarAsync(CancellationToken) con CancellationToken.None. (Heredado de DbCommand)
ExecuteScalarAsync(CancellationToken)	Obsoletos. Esta es la versión asincrónica de ExecuteScalar(). Los proveedores lo deben reemplazar con una implementación apropiada. El token de cancelación se puede omitir opcionalmente. La implementación predeterminada invoca el método sincrónico ExecuteScalar() y devuelve una tarea completada, bloqueando el subproceso de llamada. La implementación predeterminada devolverá una tarea cancelada si se pasa un token de cancelación ya cancelado. Las excepciones producidas por ExecuteScalar se comunicarán mediante la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del objeto DbCommand hasta que se haya completado la tarea devuelta. (Heredado de DbCommand)
GetHashCode()	Obsoletos. Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Obsoletos. Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obsoletos. Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Obsoletos. Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Obsoletos. Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
Prepare()	Obsoletos. Crea una versión preparada (o compilada) del comando en el origen de datos.
PrepareAsync(CancellationToken)	Obsoletos. Crea de forma asincrónica una versión preparada (o compilada) del comando en el origen de datos. (Heredado de DbCommand)
ResetCommandTimeout()	Obsoletos. Restablece el valor predeterminado de la propiedad CommandTimeout.
ToString()	Obsoletos. Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

Disposed

Obsoletos. Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)

Implementaciones de interfaz explícitas

IDbCommand.Connection	Obsoletos. Obtiene o establece la interfaz IDbConnection que usa esta instancia de IDbCommand. (Heredado de DbCommand)
IDbCommand.CreateParameter()	Obsoletos. Crea una nueva instancia de un objeto IDbDataParameter . (Heredado de DbCommand)
IDbCommand.ExecuteReader()	Obsoletos. Ejecuta CommandText contra Connection y genera IDataReader. (Heredado de DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Obsoletos. Ejecuta CommandText contra Connection y genera IDataReader mediante uno de los valores de CommandBehavior. (Heredado de DbCommand)
IDbCommand.Parameters	Obsoletos. Obtiene la estructura IDataParameterCollection. (Heredado de DbCommand)
IDbCommand.Transaction	Obsoletos. Obtiene o establece DbTransaction dentro del cual se ejecuta este objeto DbCommand. (Heredado de DbCommand)

Consulte también

• Trabajar con comandos