Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

OracleCommand (Clase)

Nota: esta API ya está obsoleta.

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

Espacio de nombres:  System.Data.OracleClient
Ensamblado:  System.Data.OracleClient (en System.Data.OracleClient.dll)

[ObsoleteAttribute("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", 
	false)]
public sealed class OracleCommand : DbCommand, 
	ICloneable

El tipo OracleCommand expone los siguientes miembros.

  NombreDescripción
Método públicoOracleCommand()Inicializa una nueva instancia de OracleCommand.
Método públicoOracleCommand(String)Inicializa una nueva instancia de la clase OracleCommand con el texto de la consulta.
Método públicoOracleCommand(String, OracleConnection)Inicializa una nueva instancia de la clase OracleCommand con el texto de la consulta y un objeto OracleConnection.
Método públicoOracleCommand(String, OracleConnection, OracleTransaction)Inicializa una nueva instancia de la clase OracleCommand con el texto de la consulta, un objeto OracleConnection y un objeto OracleTransaction.
Arriba

  NombreDescripción
Propiedad protegidaCanRaiseEventsObtiene un valor que indica si el componente puede generar un evento. (Se hereda de Component).
Propiedad públicaCommandTextObtiene o establece la instrucción SQL o el procedimiento almacenado que se va a ejecutar en la base de datos. (Invalida a DbCommand.CommandText).
Propiedad públicaCommandTimeoutObtiene o establece el tiempo de espera antes de terminar el intento de ejecutar un comando y generar un error. (Invalida a DbCommand.CommandTimeout).
Propiedad públicaCommandTypeObtiene o establece un valor que indica cómo se interpreta la propiedad CommandText. (Invalida a DbCommand.CommandType).
Propiedad públicaConnectionObtiene o establece la conexión OracleConnection que utiliza esta instancia de OracleCommand.
Propiedad públicaContainerObtiene IContainer que contiene Component. (Se hereda de Component).
Propiedad protegidaDbConnectionObtiene o establece el objeto DbConnection que utiliza este DbCommand. (Se hereda de DbCommand).
Propiedad protegidaDbParameterCollectionObtiene la colección de objetos DbParameter. (Se hereda de DbCommand).
Propiedad protegidaDbTransactionObtiene o establece la transacción DbTransaction en la que se ejecuta este objeto DbCommand. (Se hereda de DbCommand).
Propiedad protegidaDesignModeObtiene un valor que indica si Component está actualmente en modo de diseño. (Se hereda de Component).
Propiedad públicaDesignTimeVisibleObtiene o establece un valor que indica si el objeto de comando debe estar visible en un control de interfaz personalizado. (Invalida a DbCommand.DesignTimeVisible).
Propiedad protegidaEventsObtiene la lista de controladores de eventos asociados a Component. (Se hereda de Component).
Propiedad públicaParametersObtiene la colección OracleParameterCollection.
Propiedad públicaSiteObtiene o establece ISite de Component. (Se hereda de Component).
Propiedad públicaTransactionObtiene o establece el objeto OracleTransaction en el que se ejecuta OracleCommand.
Propiedad públicaUpdatedRowSourceObtiene o establece un valor que especifica cómo debe aplicar el método Update los resultados de comando al objeto DataRow. (Invalida a DbCommand.UpdatedRowSource).
Arriba

  NombreDescripción
Método públicoCancelIntenta cancelar la ejecución de un objeto OracleCommand. (Invalida a DbCommand.Cancel()).
Método públicoCloneCrea una copia de este objeto OracleCommand.
Método protegidoCreateDbParameterCrea una nueva instancia de un objeto DbParameter. (Se hereda de DbCommand).
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoCreateParameterCrea una nueva instancia de un objeto OracleParameter.
Método públicoDispose()Libera todos los recursos utilizados por el objeto Component. (Se hereda de Component).
Método protegidoDispose(Boolean)Libera los recursos no administrados usados por Component y, opcionalmente, los recursos administrados. (Se hereda de Component).
Método públicoEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegidoExecuteDbDataReaderEjecuta el texto de comando en la conexión. (Se hereda de DbCommand).
Método públicoExecuteNonQueryEjecuta una instrucción SQL en Connection y devuelve el número de filas afectadas. (Invalida a DbCommand.ExecuteNonQuery()).
Método públicoExecuteOracleNonQueryEjecuta una instrucción SQL en Connection y devuelve el número de filas afectadas.
Método públicoExecuteOracleScalarEjecuta 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 demás columnas o filas no se tienen en cuenta.
Método públicoExecuteReader()Envía CommandText a Connection y genera un objeto OracleDataReader.
Método públicoExecuteReader(CommandBehavior)Envía CommandText a Connection y crea un objeto OracleDataReader con uno de los valores de CommandBehavior.
Método públicoExecuteScalarEjecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta como un tipo de datos de .NET Framework. Las demás columnas o filas no se tienen en cuenta. (Invalida a DbCommand.ExecuteScalar()).
Método protegidoFinalizeLibera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recolección de elementos no utilizados. (Se hereda de Component).
Método públicoGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoGetServiceDevuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoMemberwiseClone() Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método públicoPrepareCrea una versión preparada (o compilada) del comando en el origen de datos. (Invalida a DbCommand.Prepare()).
Método públicoResetCommandTimeoutRestablece el valor predeterminado de la propiedad CommandTimeout.
Método públicoToStringDevuelve un objeto String que contiene el nombre del objeto Component, en caso de que exista. Este método no debe reemplazarse. (Se hereda de Component).
Arriba

  NombreDescripción
Evento públicoDisposedSe produce cuando el componente se elimina mediante una llamada al método Dispose. (Se hereda de Component).
Arriba

  NombreDescripción
Implementación explícita de interfacesPropiedad privadaIDbCommand.ConnectionObtiene o establece la interfaz IDbConnection que utiliza esta instancia de IDbCommand. (Se hereda de DbCommand).
Implementación explícita de interfacesMétodo privadoIDbCommand.CreateParameterCrea una nueva instancia de un objeto IDbDataParameter. (Se hereda de DbCommand).
Implementación explícita de interfacesMétodo privadoIDbCommand.ExecuteReader()Ejecuta el CommandText en Connection y genera un IDataReader. (Se hereda de DbCommand).
Implementación explícita de interfacesMétodo privadoIDbCommand.ExecuteReader(CommandBehavior)Ejecuta CommandText en Connection y genera un IDataReader mediante uno de los valores de CommandBehavior. (Se hereda de DbCommand).
Implementación explícita de interfacesPropiedad privadaIDbCommand.ParametersObtiene IDataParameterCollection. (Se hereda de DbCommand).
Implementación explícita de interfacesPropiedad privadaIDbCommand.TransactionObtiene o establece la transacción DbTransaction en la que se ejecuta este objeto DbCommand. (Se hereda de DbCommand).
Arriba

Este tipo está desusado y se quitará en un futura versión de .NET Framework. Para obtener más información, vea Oracle y ADO.NET.

La clase OracleCommand proporciona los siguientes métodos 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 único valor (por ejemplo, un valor agregado) de una base de datos como un tipo de datos de .NET Framework.

ExecuteOracleScalar

Recupera un único valor (por ejemplo, un valor agregado) de una base de datos como un tipo de datos específico de Oracle.

Se puede restablecer el valor de la propiedad CommandText y volver a utilizar el objeto OracleCommand.

Si la ejecución del comando genera una excepción OracleException grave, OracleConnection podría cerrarse. Sin embargo, el usuario puede volver a abrir la conexión y continuar.

NotaNota

Al contrario que el objeto Command de los demás proveedores de datos de .NET Framework (SQL Server, OLE DB y ODBC), el objeto OracleCommand no admite una propiedad CommandTimeout. La configuración del tiempo de espera de un comando no tiene ningún efecto y el valor devuelto siempre es cero.

En el ejemplo siguiente se utiliza el método ExecuteReader 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();
        }
    }
}


.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1
Obsoleto (advertencia del compilador) en 4

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft