OracleConnection OracleConnection OracleConnection OracleConnection Class

Definición

Advertencia

Esta API está ya obsoleta.

Representa una conexión abierta a una base de datos.Represents an open connection to a database. Esta clase no puede heredarse.This class cannot be inherited.

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
type OracleConnection = class
    inherit DbConnection
    interface ICloneable
Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable
Herencia
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se crea un OracleCommand y un OracleConnection.The following example creates an OracleCommand and an OracleConnection. El OracleConnection se abre y se establece como el OracleCommand.Connection propiedad.The OracleConnection is opened and set as the OracleCommand.Connection property. El ejemplo llama a ExecuteNonQueryy cierra la conexión.The example then calls ExecuteNonQuery, and closes the connection. Para lograr esto, el ExecuteNonQuery se pasa una cadena de conexión y una cadena de consulta que es una instrucción SQL INSERT.To accomplish this, the ExecuteNonQuery is passed a connection string and a query string that is an SQL INSERT statement.

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 futura versión de .NET Framework.This type is deprecated and will be removed in a future version of the .NET Framework. Para obtener más información, consulte Oracle y ADO.NET.For more information, see Oracle and ADO.NET.

Un OracleConnection objeto representa una conexión única a una base de datos de Oracle.An OracleConnection object represents a unique connection to an Oracle database. En el caso de un sistema de base de datos cliente/servidor, es equivalente a una conexión de red al servidor.In the case of a client/server database system, it is equivalent to a network connection to the server.

Una aplicación que crea una instancia de la OracleConnection puede establecer la demanda de seguridad declarativo o imperativo que requiere todos los llamadores directos e indirectos tengan los permisos adecuados en el código de objeto.An application that creates an instance of the OracleConnection object can set declarative or imperative security demands that require all direct and indirect callers to have adequate permission to the code. OracleConnection crea las peticiones de seguridad mediante la OraclePermission objeto.OracleConnection creates security demands by using the OraclePermission object. Los usuarios pueden comprobar que su código tiene los permisos adecuados mediante el OraclePermissionAttribute objeto.Users can verify that their code has adequate permissions by using the OraclePermissionAttribute object. Los usuarios y administradores también pueden usar la herramienta Directiva de seguridad de acceso a código (Caspol.exe) para modificar la directiva de seguridad en el equipo, usuario y los niveles de empresa.Users and administrators can also use the Code Access Security Policy Tool (Caspol.exe) to modify security policy at the machine, user, and enterprise levels. Para más información, consulte Seguridad.For more information, see Security.

Nota

A diferencia de la conexión objeto en los otros proveedores de datos de .NET Framework (SQL Server, OLE DB y ODBC), OracleConnection no admite un ConnectionTimeout propiedad.Unlike the Connection object in the other .NET Framework data providers (SQL Server, OLE DB, and ODBC), OracleConnection does not support a ConnectionTimeout property. 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.Setting a connection time-out either as a property or in the connection string has no effect, and the value returned is always zero. OracleConnection También no se admite un Database propiedad o un ChangeDatabase método.OracleConnection also does not support a Database property or a ChangeDatabase method.

Si el OracleConnection objeto queda fuera del ámbito, permanece abierta.If the OracleConnection object goes out of scope, it remains open. Por lo tanto, siempre debería cerrar OracleConnection objetos mediante una llamada a Close o Dispose, o mediante el OracleConnection objeto dentro de un Using instrucción.Therefore, you should always close OracleConnection objects by calling Close or Dispose, or by using the OracleConnection object within a Using statement. En caso contrario, la colección de elementos no utilizados podría no estar disponible inmediatamente.Otherwise, the garbage collection might not free them immediately. Tales demoras pueden provocar errores si se alcanza el número máximo de conexiones cuando un número de conexiones está esperando a ser eliminada por el recolector de elementos no utilizados.Such delays can cause errors if the maximum number of connections is reached while a number of connections are waiting to be deleted by the garbage collector. Por el contrario, se cierran las conexiones mediante una llamada a Close utiliza recursos nativos de forma más eficaz, mejorar la escalabilidad y mejorar el rendimiento general de la aplicación.By contrast, closing the connections by calling Close uses native resources more efficiently, enhancing scalability and improving overall application performance. Para asegurarse de que siempre se cierran las conexiones, abra la conexión dentro de un Using bloque.To ensure that connections are always closed, open the connection inside of a Using block.

Nota

Para implementar aplicaciones de alto rendimiento, a menudo necesitará usar la agrupación de conexiones.To deploy high-performance applications, you often need to use connection pooling. 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 la administra automáticamente.However, when you use the .NET Framework Data Provider for Oracle, you do not need to enable connection pooling because the provider manages this automatically.

Constructores

OracleConnection() OracleConnection() OracleConnection() OracleConnection()

Inicializa una nueva instancia de OracleConnection.Initializes a new instance of the OracleConnection.

OracleConnection(String) OracleConnection(String) OracleConnection(String) OracleConnection(String)

Inicializa una nueva instancia de la OracleConnection clase con la cadena de conexión especificada.Initializes a new instance of the OracleConnection class with the specified connection string.

Propiedades

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ConnectionString ConnectionString ConnectionString ConnectionString

Obtiene o establece la cadena utilizada para abrir una base de datos de Oracle.Gets or sets the string used to open an Oracle database.

ConnectionTimeout ConnectionTimeout ConnectionTimeout ConnectionTimeout

Obtiene el tiempo de espera para establecer una conexión antes de terminar el intento y generar un error.Gets the time to wait to establish a connection before terminating the attempt and generating an error.

Container Container Container Container

Obtiene IContainer que contiene Component.Gets the IContainer that contains the Component.

(Inherited from Component)
Database Database Database Database

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.Gets the name of the current database or the database to be used after a connection is opened.

DataSource DataSource DataSource DataSource

Obtiene el nombre del servidor de Oracle que se va a conectar.Gets the name of the Oracle server to which to connect.

DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ServerVersion ServerVersion ServerVersion ServerVersion

Obtiene una cadena que contiene la versión del servidor al que está conectado el cliente.Gets a string containing the version of the server to which the client is connected.

Site Site Site Site

Obtiene o establece el ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
State State State State

Obtiene el estado actual de la conexión.Gets the current state of the connection.

Métodos

BeginTransaction() BeginTransaction() BeginTransaction() BeginTransaction()

Inicia una transacción en la base de datos.Begins a transaction at the database.

BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel)

Inicia una transacción en la base de datos con los valores especificados IsolationLevel valor.Begins a transaction at the database with the specified IsolationLevel value.

ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String)

Cambia la base de datos actual de una conexión OracleConnection abierta.Changes the current database for an open OracleConnection.

ClearAllPools() ClearAllPools() ClearAllPools() ClearAllPools()

Vacía la agrupación de conexiones.Empties the connection pool.

ClearPool(OracleConnection) ClearPool(OracleConnection) ClearPool(OracleConnection) ClearPool(OracleConnection)

Vacía la agrupación de conexiones asociada a la conexión especificada.Empties the connection pool associated with the specified connection.

Close() Close() Close() Close()

Cierra la conexión con la base de datos.Closes the connection to the database.

CreateCommand() CreateCommand() CreateCommand() CreateCommand()

Crea y devuelve un OracleCommand objeto asociado con el OracleConnection.Creates and returns an OracleCommand object associated with the OracleConnection.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto 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)
Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

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

Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction)

Se da de alta en la transacción especificada como una transacción distribuida.Enlists in the specified transaction as a distributed transaction.

EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction)

Se da de alta en la transacción especificada como una transacción distribuida.Enlists in the specified transaction as a distributed transaction.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetSchema() GetSchema() GetSchema() GetSchema()

Devuelve información de esquema para el origen de datos de OracleConnection.Returns schema information for the data source of this OracleConnection.

GetSchema(String) GetSchema(String) GetSchema(String) GetSchema(String)

Devuelve información de esquema para el origen de datos de OracleConnection utilizando la cadena especificada para el nombre del esquema.Returns schema information for the data source of this OracleConnection using the specified string for the schema name.

GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(String, String[])

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.Returns schema information for the data source of this OracleConnection using the specified string for the schema name and the specified string array for the restriction values.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

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

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Open() Open() Open() Open()

Abre una conexión a una base de datos con los valores de propiedad especificados por el ConnectionString.Opens a connection to a database with the property settings specified by the ConnectionString.

ToString() ToString() ToString() ToString()

Devuelve una String que contiene el nombre del Component, si existe.Returns a String containing the name of the Component, if any. Este método no se debe invalidar.This method should not be overridden.

(Inherited from Component)

Eventos

Disposed Disposed Disposed Disposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
InfoMessage InfoMessage InfoMessage InfoMessage

Se produce cuando Oracle envía una mensaje de advertencia o informativo.Occurs when Oracle sends a warning or an informational message.

StateChange StateChange StateChange StateChange

Se produce cuando cambia el estado de la conexión.Occurs when the state of the connection changes.

Implementaciones de interfaz explícitas

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

Crea un nuevo objeto copiado de la instancia actual.Creates a new object that is a copy of the current instance.

IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction()

Inicia una transacción de base de datos.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel)

Inicia una transacción de base de datos con el valor de IsolationLevel especificado.Begins a database transaction with the specified IsolationLevel value.

IDbConnection.ChangeDatabase(String) IDbConnection.ChangeDatabase(String) IDbConnection.ChangeDatabase(String) IDbConnection.ChangeDatabase(String)

Cambia la base de datos actual de un objeto Connection abierto.Changes the current database for an open Connection object.

IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand()

Crea y devuelve un objeto Command asociado a la conexión.Creates and returns a Command object that is associated with the connection.

Se aplica a

Consulte también: