¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

IDbConnection (Interfaz)

Actualización: noviembre 2007

Representa una conexión abierta a un origen de datos y la implementan los proveedores de datos de .NET Framework que tienen acceso a bases de datos relacionales.

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

public interface IDbConnection : IDisposable
public interface IDbConnection extends IDisposable
public interface IDbConnection extends IDisposable

La interfaz IDbConnection permite que una clase heredada implemente una clase Connection, que representa una sesión única con un origen de datos (por ejemplo, una conexión de red con un servidor). Para obtener más información sobre las clases Connection, vea Conectar con un origen de datos (ADO.NET).

Una aplicación no crea una instancia de la interfaz IDbConnection directamente, sino que la crea de una clase que hereda de IDbConnection.

Las clases que heredan IDbConnection deben implementar todos los miembros heredados y suelen definir miembros adicionales para agregar la funcionalidad específica de proveedor. Por ejemplo, la interfaz IDbConnection define la propiedad ConnectionTimeout. A su vez, la clase SqlConnection hereda esta propiedad y también define la propiedad PacketSize.

Notas para los implementadores:

Para potenciar la coherencia entre los proveedores de datos de .NET Framework, asigne a la clase heredada un nombre con el formato PrvClassname, donde Prv es el prefijo uniforme que se asigna a todas las clases de un espacio de nombres de proveedor de datos de .NET Framework específico. Por ejemplo, Sql es el prefijo de la clase SqlConnection en el espacio de nombres System.Data.SqlClient.

Al heredar de la interfaz IDbConnection, se deben implementar los siguientes constructores:

Item

Description

PrvConnection()

Inicializa una nueva instancia de la clase PrvConnection.

PrvConnection(string connectionString)

Inicializa una nueva instancia de la clase PrvConnection cuando se proporciona una cadena que contiene la cadena de conexión.

En el ejemplo siguiente se crean instancias de las clases derivadas SqlCommand y SqlConnection. Se abre SqlConnection y se establece como Connection para SqlCommand. A continuación, en el ejemplo se llama a ExecuteNonQuery y se cierra la conexión. Para ello, se pasa a ExecuteNonQuery una cadena de conexión y una cadena de consulta que es una instrucción Transact-SQL INSERT.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
        Console.WriteLine("State: {0}", connection.State);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code, 
    // you can retrieve it from a configuration file, using the 
    // System.Configuration.ConfigurationSettings.AppSettings property 
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;";
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0

XNA Framework

Compatible con: 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft