OleDbConnection Clase

Definición

Espacio de nombres:

System.Data.OleDb

Ensamblado:

System.Data.dll

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

MarshalByRefObject

Component

DbConnection

OleDbConnection

Implementaciones

IDbConnection ICloneable IDisposable

Ejemplos

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

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, es equivalente a una conexión de red al servidor. Dependiendo de 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 OleDbConnection. 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.

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

Note

Para implementar aplicaciones de alto rendimiento, debe usar la agrupación de conexiones. Cuando se usa la .NET Framework Proveedor de datos 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 la Proveedor de datos de .NET Framework para OLE DB, consulte OLE DB, ODBC y Oracle Connection Pooling.

Si un > /, es posible que se cierre el . 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 autores de llamadas directos e indirectos tengan permiso suficiente para el código estableciendo demandas de seguridad declarativas o imperativas. OleDbConnection hace 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, consulte Seguridad de acceso de código y ADO.NET.

Para obtener más información sobre cómo controlar mensajes informativos e de advertencia desde el servidor de datos, vea Eventos de conexión.

Note

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

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

Propiedades

Nombre	Description
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
ConnectionString	Obtiene o establece la cadena utilizada para abrir una base de datos.
ConnectionTimeout	Obtiene el tiempo de espera (en segundos) al intentar establecer una conexión antes de finalizar el intento y generar un error.
Container	Obtiene el IContainer objeto que contiene el Componentobjeto . (Heredado de Component)
Database	Obtiene el nombre de la base de datos actual o de la base de datos que se va a usar después de abrir una conexión.
DataSource	Obtiene el nombre del servidor o el nombre de archivo del origen de datos.
DbProviderFactory	Obtiene para DbProviderFactory este DbConnectionobjeto . (Heredado de DbConnection)
DesignMode	Obtiene un valor que indica si Component el objeto está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos que están asociados a este Componentobjeto . (Heredado de Component)
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.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
State	Obtiene el estado actual de la conexión.

Métodos

Nombre	Description
BeginDbTransaction(IsolationLevel)	Cuando se invalida en una clase derivada, inicia una transacción de base de datos. (Heredado de DbConnection)
BeginTransaction()	Inicia una transacción de base de datos con el valor actual IsolationLevel .
BeginTransaction(IsolationLevel)	Inicia una transacción de base de datos con el nivel de aislamiento especificado.
ChangeDatabase(String)	Cambia la base de datos actual de un objeto abierto OleDbConnection.
Close()	Cierra la conexión al origen de datos.
CreateCommand()	Crea y devuelve un OleDbCommand objeto asociado a .OleDbConnection
CreateDbCommand()	Cuando se invalida en una clase derivada, crea y devuelve un DbCommand objeto asociado a la conexión actual. (Heredado de DbConnection)
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
EnlistDistributedTransaction(ITransaction)	Se inscribe en la transacción especificada como una transacción distribuida.
EnlistTransaction(Transaction)	Se inscribe en la transacción especificada como una transacción distribuida.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa 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)
GetOleDbSchemaTable(Guid, Object[])	Devuelve información de esquema de un origen de datos tal como se indica en un GUID y después de aplicar las restricciones especificadas.
GetSchema()	Devuelve información de esquema para el origen de datos de este OleDbConnection.
GetSchema(String, String[])	Devuelve información de esquema para el origen de datos de esta OleDbConnection utilizando la cadena especificada para el nombre del esquema y la matriz de cadenas especificada para los valores de restricción.
GetSchema(String)	Devuelve información de esquema para el origen de datos de este OleDbConnection utilizando la cadena especificada para el nombre del esquema.
GetService(Type)	Devuelve un objeto que representa un servicio proporcionado por Component o por su Container. (Heredado de Component)
GetType()	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()	Crea una copia superficial del Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Genera el evento StateChange. (Heredado de DbConnection)
Open()	Abre una conexión de base de datos con la configuración de propiedad especificada por .ConnectionString
OpenAsync()	Una versión asincrónica de , que abre una conexión de base de Open()datos con la configuración especificada por .ConnectionString Este método invoca el método OpenAsync(CancellationToken) virtual con CancellationToken.None. (Heredado de DbConnection)
OpenAsync(CancellationToken)	Esta es la versión asincrónica de Open(). Los proveedores deben invalidar con una implementación adecuada. Opcionalmente, se puede respetar el token de cancelación. La implementación predeterminada invoca la llamada sincrónica Open() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa una cancellationToken ya cancelada. Las excepciones producidas por Open se comunicarán a través de la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del DbConnection objeto hasta que se complete la tarea devuelta. (Heredado de DbConnection)
ReleaseObjectPool()	Indica que el OleDbConnection grupo de objetos se puede liberar cuando se libera la última conexión subyacente.
ResetState()	Actualiza la State propiedad del OleDbConnection objeto .
ToString()	Devuelve un String objeto que contiene el nombre de Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

Nombre	Description
Disposed	Se produce cuando el componente se elimina mediante una llamada al Dispose() método . (Heredado de Component)
InfoMessage	Se produce cuando el proveedor envía una advertencia o un mensaje informativo.
StateChange	Se produce cuando cambia el estado de la conexión. (Heredado de DbConnection)

Implementaciones de interfaz explícitas

Nombre	Description
ICloneable.Clone()	Para obtener una descripción de este miembro, vea Clone().
IDbConnection.BeginTransaction()	Inicia una transacción de base de datos. (Heredado de DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Comienza una transacción de base de datos con el nivel de aislamiento especificado. (Heredado de DbConnection)
IDbConnection.CreateCommand()	Crea y devuelve un DbCommand objeto asociado a la conexión actual. (Heredado de DbConnection)

Consulte también

• Conexión a orígenes de datos