Este documento describe la clase OleDbConnection en .NET, la cual representa una conexión a una base de datos y provee propiedades y métodos para abrir, cerrar y administrar la conexión. Algunas propiedades clave incluyen ConnectionString, State y Database, y métodos importantes son Open, Close, CreateCommand y GetSchema. La clase hereda funcionalidad de conexión de base de datos de DbConnection y permite el acceso a datos a través de OLE DB.
2. OleDbConnection (Clase)
• Representa una conexión única a un origen de datos. En el
caso de un sistema de bases de datos de cliente y servidor,
equivale a una conexión de red al servidor. Dependiendo de
la funcionalidad que admita el proveedor OLE DB nativo,
algunos métodos o propiedades de un objeto
OleDbConnection pueden no estar disponibles.
4. Propiedades
ConnectionString Obtiene o establece la cadena que se utiliza para
abrir una base de datos.(Reemplaza
aDbConnection.ConnectionString).
ConnectionTimeout Obtiene el tiempo de espera para intentar establecer
una conexión antes de detenerse y generar un
error.(Reemplaza
a DbConnection.ConnectionTimeout).
Container Obtiene IContainer que
contiene Component.(Heredado de Component.)
5. Propiedades
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.(Reemplaza a DbConnection.Database).
DataSource Obtiene el nombre de archivo o el nombre de
servidor del origen de datos.(Reemplaza
aDbConnection.DataSource).
Provider Obtiene el nombre del proveedor OLE DB
especificado en la cláusula "Provider= " de la
cadena de conexión.
6. Propiedades
ServerVersion Obtiene una cadena que contiene la
versión del servidor al que está
conectado el cliente.(Reemplaza
aDbConnection.ServerVersion).
Site Obtiene o
establece ISite de Component.(Hereda
do de Component.)
State Obtiene el estado actual de la
conexión.(Reemplaza
a DbConnection.State).
7. Métodos
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.
ChangeDatabase(String) Cambia la base de datos actual de una
conexión OleDbConnection abierta.(Re
emplaza
a DbConnection.ChangeDatabase(Strin
g)).
8. Métodos
Close() Cierra la conexión al origen de
datos.(Reemplaza
a DbConnection.Close()).
CreateCommand() Crea y devuelve un
objeto OleDbCommand asociado
a OleDbConnection.
CreateObjRef(Type) Crea un objeto que contiene toda la
información relevante necesaria para
generar un proxy utilizado para
comunicarse con un objeto
remoto.(Heredado
deMarshalByRefObject.)
9. Métodos
Dispose() Libera todos los recursos utilizados
por Component.(Heredado
de Component.)
EnlistDistributedTransaction(ITransaction) Se da de alta en la transacción
especificada como una transacción
distribuida.
EnlistTransaction(Transaction) Se da de alta en la transacción
especificada como una transacción
distribuida.(Reemplaza
a DbConnection.EnlistTransaction(Trans
action)).
10. Métodos
Equals(Object) Determina si el objeto especificado es
igual al objeto actual.(Heredado
de Object.)
GetHashCode() Sirve como una función hash para un tipo
en particular. (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.)
11. Métodos
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.(Reemplaza
a DbConnection.GetSchema()).
GetSchema(String) Devuelve información de esquema para el
origen de datos
de OleDbConnectionutilizando la cadena
especificada para el nombre del
esquema.(Reemplaza
aDbConnection.GetSchema(String)).
12. Métodos
GetSchema(String, String()) Devuelve información de esquema para el
origen de datos
de OleDbConnectionutilizando la cadena
especificada para el nombre de esquema y
la matriz de cadena determinada para los
valores de restricción.(Reemplaza
aDbConnection.GetSchema(String, String
())).
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.)
13. Métodos
Open() Abre una conexión de base de datos con
los valores de propiedad que
especificaConnectionString.(Reemplaza
a DbConnection.Open()).
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 virtualOpenAsync con
CancellationToken.None.(Heredado
de DbConnection.)
14. Métodos
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.)
15. Métodos
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 un objeto String que contiene
el nombre del objeto Component, en
caso de que exista.Este método no debe
reemplazarse.(Heredado deComponent.)
16. Eventos
Nombre Descripción
Disposed Se produce cuando el componente se
elimina mediante una llamada al
método Dispose. (Heredado
deComponent.)
InfoMessage Se produce cuando el proveedor envía un
mensaje de advertencia o de información.
StateChange Se produce cuando cambia el estado del
evento.(Heredado de DbConnection.)
17. Fuente
• OleDbConnection (Clase). https://msdn.microsoft.com/es-
es/library/system.data.oledb.oledbconnection(v=vs.110).aspx recuperado el 1 de
Noviembre 2015.