Exportar (0) Imprimir
Expandir todo

OleDbConnection (Clase)

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

Espacio de nombres: System.Data.OleDb
Ensamblado: System.Data (en system.data.dll)

public sealed class OleDbConnection : 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.

NotaNota

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.

NotaNota

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 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.
        }

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft