OleDbConnection Clase

Definición

Espacio de nombres:

System.Data.OleDb

Ensamblado:

System.Data.OleDb.dll

Paquete:

System.Data.OleDb v8.0.0

Source:

OleDbConnection.cs

Representa una conexión abierta a un origen de datos.

public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable

public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable

type OleDbConnection = class
    inherit DbConnection
    interface ICloneable
    interface IDbConnection
    interface IDisposable

Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable

Herencia

Object

DbConnection

OleDbConnection

Implementaciones

IDbConnection ICloneable IDisposable

Ejemplos

En el ejemplo siguiente se crea un OleDbCommand objeto y .OleDbConnection OleDbConnection se abre y se establece como para Connection .OleDbCommand A continuación, el ejemplo llama ExecuteNonQuery a y 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 insertSQL)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OleDbCommand command = new OleDbCommand(insertSQL);

        // Set the Connection to the new OleDbConnection.
        command.Connection = connection;

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OleDbConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OleDbCommand(insertSQL)

        ' Set the Connection to the new OleDbConnection.
        command.Connection = connection

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Comentarios

Un OleDbConnection objeto representa una conexión única a un origen de datos. Con un sistema de base de datos cliente/servidor, equivale a una conexión de red al servidor. Según la funcionalidad admitida por el proveedor OLE DB nativo, es posible que algunos métodos o propiedades de un OleDbConnection objeto no estén disponibles.

Al crear una instancia de OleDbConnection, todas las propiedades se establecen en sus valores iniciales. Para obtener una lista de estos valores, consulte el OleDbConnection constructor .

Puede abrir más de un objeto DataReader en un solo OleDbConnectionobjeto . Si el proveedor OLE DB que usa no admite más de un DataReader en una sola conexión, el proveedor abre implícitamente una conexión adicional para cada una.

OleDbConnection Si sale del ámbito, no se cierra. Por lo tanto, debe cerrar explícitamente la conexión mediante una llamada a Close o Dispose, o mediante el uso del OleDbConnection objeto dentro de una Using instrucción .

Nota

Para implementar aplicaciones de alto rendimiento, debe usar la agrupación de conexiones. Cuando se usa el proveedor de datos de .NET Framework para OLE DB, no es necesario habilitar la agrupación de conexiones porque el proveedor lo administra automáticamente. Para obtener más información sobre cómo usar la agrupación de conexiones con el proveedor de datos de .NET Framework para OLE DB, vea OLE DB, ODBC y grupos de conexiones de Oracle.

Si un valor irrecuperable OleDbException (por ejemplo, un nivel de gravedad de SQL Server de 20 o superior) se genera mediante el método que ejecuta , OleDbConnectionOleDbCommandes posible que se cierre . Sin embargo, el usuario puede volver a abrir la conexión y continuar.

Una aplicación que crea una instancia del OleDbConnection objeto puede requerir que todos los llamadores directos e indirectos tengan permiso suficiente para el código estableciendo demandas de seguridad declarativas o imperativas. OleDbConnection realiza demandas de seguridad mediante el OleDbPermission objeto . Los usuarios pueden comprobar que su código tiene permisos suficientes mediante el OleDbPermissionAttribute objeto . Los usuarios y administradores también pueden usar la Caspol.exe (herramienta de directiva de seguridad de acceso de código) para modificar la directiva de seguridad en los niveles de equipo, usuario y empresa. Para obtener más información, consulta Code Access Security and ADO.NET.

Para obtener más información sobre el control de mensajes informativos y de advertencia desde el servidor de datos, consulte Eventos de conexión.

Nota

El OleDbConnection objeto no admite la configuración ni la recuperación de propiedades dinámicas específicas de un proveedor OLE DB. Solo se admiten las propiedades que se pueden proporcionar en la cadena de conexión para el proveedor OLE DB.

Constructores

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

Propiedades

CanCreateBatch	Obtiene un valor que indica si esta instancia de DbConnection admite la clase DbBatch. (Heredado de DbConnection)
ConnectionString	Obtiene o establece la cadena que se utiliza para abrir una base de datos.
ConnectionTimeout	Obtiene el tiempo de espera (en segundos) mientras se intenta establecer una conexión antes de que se interrumpa el intento y se genere un error.
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.
DataSource	Obtiene el nombre de archivo o el nombre de servidor del origen de datos.
DbProviderFactory	Obtiene el objeto DbProviderFactory para este objeto DbConnection. (Heredado de DbConnection)
Provider	Obtiene el nombre del proveedor OLE DB especificado en la cláusula "Provider= " de la cadena de conexión.
ServerVersion	Obtiene una cadena que contiene la versión del servidor al que está conectado el cliente.
State	Obtiene el estado actual de la conexión.

Métodos

BeginDbTransaction(IsolationLevel)	Cuando se invalida en una clase derivada, inicia una transacción de base de datos. (Heredado de DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Inicia de forma asincrónica una transacción de base de datos. (Heredado de DbConnection)
BeginTransaction()	Inicia una transacción de base de datos con el valor actual de IsolationLevel.
BeginTransaction(IsolationLevel)	Inicia una transacción de base de datos con el nivel de aislamiento especificado.
BeginTransactionAsync(CancellationToken)	Empieza de forma asincrónica una transacción de base de datos. (Heredado de DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Empieza de forma asincrónica una transacción de base de datos. (Heredado de DbConnection)
ChangeDatabase(String)	Cambia la base de datos actual de una conexión OleDbConnection abierta.
ChangeDatabaseAsync(String, CancellationToken)	Cambia de forma asincrónica la base de datos actual de una conexión abierta. (Heredado de DbConnection)
Close()	Cierra la conexión al origen de datos.
CloseAsync()	Cierra de forma asincrónica la conexión con la base de datos. (Heredado de DbConnection)
CreateBatch()	Devuelve una nueva instancia de la clase del proveedor que implementa la clase DbBatch. (Heredado de DbConnection)
CreateCommand()	Crea y devuelve un objeto OleDbCommand asociado a OleDbConnection.
CreateDbBatch()	Cuando se reemplaza en una clase derivada, devuelve una nueva instancia de la clase del proveedor que implementa la DbBatch clase . (Heredado de DbConnection)
CreateDbCommand()	Cuando se reemplaza en una clase derivada, crea y devuelve un objeto DbCommand asociado a la conexión actual. (Heredado de DbConnection)
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de DbConnection)
Dispose(Boolean)	Libera los recursos no administrados que usa DbConnection y, de forma opcional, libera los recursos administrados. (Heredado de DbConnection)
DisposeAsync()	Desecha de forma asincrónica el objeto de conexión. (Heredado de DbConnection)
EnlistTransaction(Transaction)	Se da de alta en la transacción especificada como una transacción distribuida.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetOleDbSchemaTable(Guid, Object[])	Devuelve información de esquema desde un origen de datos tal y como indica un GUID, y después de aplicar las restricciones especificadas.
GetSchema()	Devuelve información de esquema para el origen de datos de OleDbConnection.
GetSchema(String)	Devuelve información de esquema para el origen de datos de OleDbConnection utilizando la cadena especificada para el nombre del esquema.
GetSchema(String, String[])	Devuelve información de esquema para el origen de datos de OleDbConnection utilizando la cadena especificada para el nombre del esquema y la matriz de cadena determinada para los valores de restricción.
GetSchemaAsync(CancellationToken)	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)	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)	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)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnStateChange(StateChangeEventArgs)	Genera el evento StateChange. (Heredado de DbConnection)
Open()	Abre una conexión de base de datos con los valores de propiedad que especifica ConnectionString.
OpenAsync()	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)	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)
ReleaseObjectPool()	Indica que la agrupación de objetos OleDbConnection podrá liberarse cuando se libere la última conexión subyacente.
ResetState()	Actualiza la propiedad State del objeto OleDbConnection.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

InfoMessage	Se produce cuando el proveedor envía un mensaje de advertencia o de información.
StateChange	Se produce cuando cambia el estado de la conexión. (Heredado de DbConnection)

Implementaciones de interfaz explícitas

ICloneable.Clone()

Para obtener una descripción de este miembro, vea Clone().

Consulte también

• Conectarse a orígenes de datos