OracleConnection Clase

Definición

Espacio de nombres:

System.Data.OracleClient

Ensamblado:

System.Data.OracleClient.dll

Precaución

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

Representa una conexión abierta a una base de datos. Esta clase no puede heredarse.

public ref class OracleConnection sealed : System::Data::Common::DbConnection, ICloneable

[System.Obsolete("OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnection : System.Data.Common.DbConnection, ICloneable

[<System.Obsolete("OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnection = class
    inherit DbConnection
    interface ICloneable

Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable

Herencia

Object

MarshalByRefObject

Component

DbConnection

OracleConnection

Atributos

ObsoleteAttribute

Implementaciones

ICloneable

Ejemplos

En el ejemplo siguiente se crea un OracleCommand objeto y .OracleConnection OracleConnection se abre y se establece como la OracleCommand.Connection propiedad . A continuación, el ejemplo llama a ExecuteNonQueryy cierra la conexión. Para ello, ExecuteNonQuery se pasa una cadena de conexión y una cadena de consulta que es una instrucción SQL INSERT.

public void InsertRow(string connectionString)
{
    string queryString =
        "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString);
        command.Connection = connection;
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

Public Sub InsertRow(ByVal connectionString As String)
    Dim queryString As String = _
      "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')"

    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString)
        command.Connection = connection
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Using
End Sub

Comentarios

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

Un OracleConnection objeto representa una conexión única a una base de datos de Oracle. En el caso de un sistema de base de datos cliente/servidor, equivale a una conexión de red al servidor.

Una aplicación que crea una instancia del OracleConnection objeto puede establecer demandas de seguridad declarativas o imperativas que requieren que todos los llamadores directos e indirectos tengan el permiso adecuado para el código. OracleConnection crea demandas de seguridad mediante el OraclePermission objeto . Los usuarios pueden comprobar que su código tiene los permisos adecuados mediante el OraclePermissionAttribute objeto . Los usuarios y administradores también pueden usar la Herramienta de directiva de seguridad de acceso al código (Caspol.exe) para modificar la directiva de seguridad en los niveles de equipo, usuario y empresa. Para obtener más información, consulte Seguridad.

Nota:

A diferencia del objeto Connection de los otros proveedores de datos de .NET Framework (SQL Server, OLE DB y ODBC), OracleConnection no admite una ConnectionTimeout propiedad . Establecer un tiempo de espera de conexión como una propiedad o en la cadena de conexión no tiene ningún efecto y el valor devuelto siempre es cero. OracleConnection tampoco admite una Database propiedad ni un ChangeDatabase método .

Si el OracleConnection objeto sale del ámbito, permanece abierto. Por lo tanto, siempre debe cerrar OracleConnection objetos llamando a Close o Dispose, o usando el OracleConnection objeto dentro de una Using instrucción . De lo contrario, es posible que la recolección de elementos no utilizados no los libere inmediatamente. Estos retrasos pueden provocar errores si se alcanza el número máximo de conexiones mientras el recolector de elementos no utilizados está esperando la eliminación de una serie de conexiones. Por el contrario, cerrar las conexiones mediante una llamada a Close usa recursos nativos de forma más eficaz, lo que mejora la escalabilidad y mejora el rendimiento general de las aplicaciones. Para asegurarse de que las conexiones estén siempre cerradas, abra la conexión dentro de un Using bloque .

Nota:

Para implementar aplicaciones de alto rendimiento, a menudo debe usar la agrupación de conexiones. Sin embargo, cuando se usa el proveedor de datos de .NET Framework para Oracle, no es necesario habilitar la agrupación de conexiones porque el proveedor lo administra automáticamente.

Constructores

OracleConnection()	Obsoletos. Inicializa una nueva instancia de OracleConnection.
OracleConnection(String)	Obsoletos. Inicializa una nueva instancia de la clase OracleConnection con la cadena de conexión especificada.

Propiedades

CanCreateBatch	Obsoletos. Obtiene un valor que indica si esta instancia de DbConnection admite la clase DbBatch. (Heredado de DbConnection)
CanRaiseEvents	Obsoletos. Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
ConnectionString	Obsoletos. Obtiene o establece la cadena que se utiliza para abrir una base de datos de Oracle.
ConnectionTimeout	Obsoletos. Obtiene el tiempo de espera para establecer una conexión antes de detener el intento y generar un error.
Container	Obsoletos. Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
Database	Obsoletos. Obtiene el nombre de la base de datos actual o de la que se va a utilizar una vez que se abre la conexión.
DataSource	Obsoletos. Obtiene el nombre del servidor Oracle con el que se va a establecer la conexión.
DbProviderFactory	Obsoletos. Obtiene el objeto DbProviderFactory para este objeto DbConnection. (Heredado de DbConnection)
DesignMode	Obsoletos. Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obsoletos. Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
ServerVersion	Obsoletos. Obtiene una cadena que contiene la versión del servidor al que está conectado el cliente.
Site	Obsoletos. Obtiene o establece ISite de Component. (Heredado de Component)
State	Obsoletos. Obtiene el estado actual de la conexión.

Métodos

BeginDbTransaction(IsolationLevel)	Obsoletos. Cuando se invalida en una clase derivada, inicia una transacción de base de datos. (Heredado de DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Obsoletos. Inicia de forma asincrónica una transacción de base de datos. (Heredado de DbConnection)
BeginTransaction()	Obsoletos. Inicia una transacción en la base de datos.
BeginTransaction(IsolationLevel)	Obsoletos. Inicia una transacción en la base de datos con el valor de IsolationLevel especificado.
BeginTransactionAsync(CancellationToken)	Obsoletos. Empieza de forma asincrónica una transacción de base de datos. (Heredado de DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Obsoletos. Empieza de forma asincrónica una transacción de base de datos. (Heredado de DbConnection)
ChangeDatabase(String)	Obsoletos. Cambia la base de datos actual de una conexión OracleConnection abierta.
ChangeDatabaseAsync(String, CancellationToken)	Obsoletos. Cambia de forma asincrónica la base de datos actual de una conexión abierta. (Heredado de DbConnection)
ClearAllPools()	Obsoletos. Vacía la agrupación de conexiones.
ClearPool(OracleConnection)	Obsoletos. Vacía la agrupación de conexiones asociada a la conexión especificada.
Close()	Obsoletos. Cierra la conexión con la base de datos.
CloseAsync()	Obsoletos. Cierra de forma asincrónica la conexión con la base de datos. (Heredado de DbConnection)
CreateBatch()	Obsoletos. Devuelve una nueva instancia de la clase del proveedor que implementa la clase DbBatch. (Heredado de DbConnection)
CreateCommand()	Obsoletos. Crea y devuelve un objeto OracleCommand asociado a OracleConnection.
CreateDbBatch()	Obsoletos. Cuando se invalida en una clase derivada, devuelve una nueva instancia de la clase del proveedor que implementa la DbBatch clase . (Heredado de DbConnection)
CreateDbCommand()	Obsoletos. Cuando se reemplaza en una clase derivada, crea y devuelve un objeto DbCommand asociado a la conexión actual. (Heredado de DbConnection)
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)
Dispose()	Obsoletos. Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de DbConnection)
Dispose(Boolean)	Obsoletos. Libera los recursos no administrados que usa DbConnection y, de forma opcional, libera los recursos administrados. (Heredado de DbConnection)
DisposeAsync()	Obsoletos. Desecha de forma asincrónica el objeto de conexión. (Heredado de DbConnection)
EnlistDistributedTransaction(ITransaction)	Obsoletos. Se da de alta en la transacción especificada como una transacción distribuida.
EnlistTransaction(Transaction)	Obsoletos. Se da de alta en la transacción especificada como una transacción distribuida.
Equals(Object)	Obsoletos. Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
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)
GetSchema()	Obsoletos. Devuelve información de esquema para el origen de datos de OracleConnection.
GetSchema(String)	Obsoletos. Devuelve información de esquema para el origen de datos de OracleConnection utilizando la cadena especificada para el nombre del esquema.
GetSchema(String, String[])	Obsoletos. Devuelve información de esquema para el origen de datos de OracleConnection utilizando la cadena especificada para el nombre del esquema y la matriz de cadena determinada para los valores de restricción.
GetSchemaAsync(CancellationToken)	Obsoletos. Esta es una versión asincrónica de GetSchema(). Los proveedores lo deben reemplazar con una implementación apropiada. Opcionalmente, se puede respetar cancellationToken. La implementación predeterminada invoca la llamada sincrónica a GetSchema() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado. Las excepciones producidas por GetSchema() se comunicarán mediante la propiedad Task Exception devuelta. (Heredado de DbConnection)
GetSchemaAsync(String, CancellationToken)	Obsoletos. Esta es la versión asincrónica de GetSchema(String). Los proveedores lo deben reemplazar con una implementación apropiada. Opcionalmente, se puede respetar cancellationToken. La implementación predeterminada invoca la llamada sincrónica a GetSchema(String) y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado. Las excepciones producidas por GetSchema(String) se comunicarán mediante la propiedad Task Exception devuelta. (Heredado de DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Obsoletos. Esta es la versión asincrónica de GetSchema(String, String[]). Los proveedores lo deben reemplazar con una implementación apropiada. Opcionalmente, se puede respetar cancellationToken. La implementación predeterminada invoca la llamada sincrónica a GetSchema(String, String[]) y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado. Las excepciones producidas por GetSchema(String, String[]) se comunicarán mediante la propiedad Task Exception devuelta. (Heredado de DbConnection)
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)
OnStateChange(StateChangeEventArgs)	Obsoletos. Genera el evento StateChange. (Heredado de DbConnection)
Open()	Obsoletos. Abre una conexión a una base de datos con la configuración de propiedades especificada en ConnectionString.
OpenAsync()	Obsoletos. Una versión asincrónica de Open(), que abre una conexión a bases de datos con los valores especificados por ConnectionString. Este método invoca el método virtual OpenAsync(CancellationToken) con CancellationToken.None. (Heredado de DbConnection)
OpenAsync(CancellationToken)	Obsoletos. Esta es la versión asincrónica de Open(). Los proveedores lo deben reemplazar con una implementación apropiada. El token de cancelación se puede aceptar opcionalmente. La implementación predeterminada invoca la llamada sincrónica a Open() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado. Las excepciones producidas por Open se comunicarán mediante la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del objeto DbConnection hasta que se haya completado la tarea devuelta. (Heredado de DbConnection)
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)
InfoMessage	Obsoletos. Se produce cuando Oracle envía un mensaje de advertencia o de información.
StateChange	Obsoletos. Se produce cuando cambia el estado de la conexión. (Heredado de DbConnection)

Implementaciones de interfaz explícitas

ICloneable.Clone()	Obsoletos. Crea un nuevo objeto copiado de la instancia actual.
IDbConnection.BeginTransaction()	Obsoletos. Inicia una transacción de base de datos. (Heredado de DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Obsoletos. Inicia una transacción de base de datos con el nivel de aislamiento especificado. (Heredado de DbConnection)
IDbConnection.CreateCommand()	Obsoletos. Crea y devuelve un objeto DbCommand asociado a la conexión actual. (Heredado de DbConnection)

Consulte también

• OracleDataAdapter
• OracleCommand