OracleConnection Clase

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. https://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 la propiedad OracleCommand.Connection.The OracleConnection is opened and set as the OracleCommand.Connection property. A continuación, en el ejemplo se llama a ExecuteNonQueryy se cierra la conexión.The example then calls ExecuteNonQuery, and closes the connection. Para ello, se pasa al ExecuteNonQuery una cadena de conexión y una cadena de consulta que es una instrucción INSERT de SQL.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 versión futura del .NET Framework.This type is deprecated and will be removed in a future version of the .NET Framework. Para obtener más información, vea Oracle y ADO.net.For more information, see Oracle and ADO.NET.

Un objeto OracleConnection 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 del objeto OracleConnection 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.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 demandas de seguridad mediante el objeto OraclePermission.OracleConnection creates security demands by using the OraclePermission object. Los usuarios pueden comprobar que el 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 los administradores también pueden utilizar la herramienta de la Directiva de seguridad de acceso del código (Caspol. exe) para modificar la Directiva de seguridad en los niveles de equipo, usuario y 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 del objeto de conexión del otro .NET Framework proveedores de datos (SQL Server, OLE DB y ODBC), OracleConnection no admite una propiedad ConnectionTimeout.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 tampoco admite una propiedad Database o un método ChangeDatabase.OracleConnection also does not support a Database property or a ChangeDatabase method.

Si el objeto de OracleConnection sale del ámbito, permanece abierto.If the OracleConnection object goes out of scope, it remains open. Por lo tanto, siempre debe cerrar los objetos OracleConnection llamando a Close o Dispose, o bien mediante el objeto OracleConnection dentro de una instrucción Using.Therefore, you should always close OracleConnection objects by calling Close or Dispose, or by using the OracleConnection object within a Using statement. De lo contrario, es posible que la recolección de elementos no utilizados no las libere inmediatamente.Otherwise, the garbage collection might not free them immediately. Estos retrasos pueden producir errores si se alcanza el número máximo de conexiones mientras un número de conexiones está esperando a ser eliminados 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, el cierre de las conexiones mediante una llamada a Close utiliza recursos nativos de manera más eficaz, mejorando la escalabilidad y mejorando 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 las conexiones estén siempre cerradas, abra la conexión dentro de un bloque de Using.To ensure that connections are always closed, open the connection inside of a Using block.

Nota

Para implementar aplicaciones de alto rendimiento, a menudo es necesario 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()

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

OracleConnection(String)

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

Propiedades

CanRaiseEvents

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

(Heredado de Component)
ConnectionString

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

ConnectionTimeout

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

Container

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

(Heredado de Component)
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

Obtiene el nombre del servidor Oracle con el que se va a establecer la conexión.Gets the name of the Oracle server to which to connect.

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.

(Heredado de Component)
Events

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

(Heredado de Component)
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

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

(Heredado de Component)
State

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

Métodos

BeginTransaction()

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

BeginTransaction(IsolationLevel)

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

ChangeDatabase(String)

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

ClearAllPools()

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

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

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

CreateCommand()

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

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.

(Heredado de MarshalByRefObject)
Dispose()

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

(Heredado de Component)
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.

(Heredado de Component)
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)

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)

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

(Heredado de Object)
GetHashCode()

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

(Heredado de Object)
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.

(Heredado de MarshalByRefObject)
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)

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[])

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)

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.

(Heredado de Component)
GetType()

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

(Heredado de Object)
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.

(Heredado de MarshalByRefObject)
MemberwiseClone()

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

(Heredado de Object)
MemberwiseClone(Boolean)

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

(Heredado de MarshalByRefObject)
Open()

Abre una conexión a una base de datos con la configuración de propiedades especificada en ConnectionString.Opens a connection to a database with the property settings specified by the ConnectionString.

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.

(Heredado de Component)

Eventos

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.

(Heredado de Component)
InfoMessage

Se produce cuando Oracle envía un mensaje de advertencia o de información.Occurs when Oracle sends a warning or an informational message.

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

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

IDbConnection.BeginTransaction()

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

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)

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

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: