Representa una conexión abierta a un origen de datos.
Espacio de nombres: System.Data.OleDb
Ensamblado: System.Data (en system.data.dll)
Visual Basic (Declaración)
Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDbConnection, IDisposable
Dim instance As OleDbConnection
public sealed class OleDbConnection : DbConnection, ICloneable, IDbConnection, IDisposable
public ref class OleDbConnection sealed : public DbConnection, ICloneable, IDbConnection, IDisposable
public final class OleDbConnection extends DbConnection implements ICloneable, IDbConnection,
IDisposable
public final class OleDbConnection extends DbConnection implements ICloneable, IDbConnection,
IDisposable
Objeto OleDbConnection que 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.
Cuando se crea una instancia de OleDbConnection, se establecen todas las propiedades en sus valores iniciales. Para obtener una lista de esos valores, vea el constructor OleDbConnection.
Si la conexión OleDbConnection está fuera de ámbito, no se cierra. Por consiguiente, es preciso cerrar explícitamente la conexión llamando a Close o Dispose, o utilizando el objeto OleDbConnection en una instrucción Using.
Nota |
|---|
| Para implementar aplicaciones de alto rendimiento, es necesario utilizar la agrupación de conexiones. Cuando se utiliza el proveedor de datos de .NET Framework para OLE DB, no es necesario habilitar la agrupación de conexiones porque el proveedor se encarga de ello automáticamente. Para obtener más información sobre cómo utilizar las agrupaciones de conexiones con el proveedor de datos de .NET Framework para OLE DB, vea Descripción de agrupación de conexiones. |
Si se genera una excepción OleDbException grave (por ejemplo, un nivel de gravedad de SQL Server de 20 o superior) por parte del método que ejecuta OleDbCommand, es posible que se cierre OleDbConnection. Sin embargo, el usuario puede volver a abrir la conexión y continuar.
Una aplicación que crea una instancia del objeto OleDbConnection puede requerir que todos los llamadores directos e indirectos tengan permisos suficientes en el código estableciendo solicitudes de seguridad declarativas o imperativas. OleDbConnection realiza solicitudes de seguridad utilizando el objeto OleDbPermission. Los usuarios pueden comprobar que el código tiene los permisos adecuados mediante el objeto OleDbPermissionAttribute. Los usuarios y administradores también pueden utilizar la Herramienta de la directiva de seguridad de acceso a código (Caspol.exe) para modificar la directiva de seguridad en los niveles de equipo, usuario y empresa. Para obtener más información, vea Seguridad de acceso a código y ADO.NET.
Para obtener más información sobre el tratamiento de mensajes informativos y de advertencia del servidor de datos, vea Trabajar con eventos de conexión.
Nota |
|---|
| El objeto OleDbConnection no admite el establecimiento o la recuperación de propiedades dinámicas específicas de un proveedor OLE DB. Sólo se admiten las propiedades que pueden pasarse en la cadena de conexión del proveedor OLE DB. |
En el siguiente ejemplo se crean un objeto OleDbCommand y un objeto OleDbConnection. Se abre OleDbConnection y se establece como la propiedad Connection de OleDbCommand. A continuación, en el ejemplo se llama a ExecuteNonQuery y se cierra la conexión. Para lograr esto, se pasa a ExecuteNonQuery una cadena de conexión y una cadena de consulta que es una instrucción INSERT de SQL.
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
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.
}
using System;
using System.Data;
using System.Data.OleDb;
class Class1
{
static void Main()
{
}
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.
}
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DbConnection
System.Data.OleDb.OleDbConnection
Seguridad para subprocesos
Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
.NET Framework
Compatible con: 2.0, 1.1, 1.0