L'interface IDbConnection permet à une classe qui hérite d'implémenter une classe Connection représentant une session unique avec une source de données (par exemple, une connexion réseau à un serveur). Pour plus d'informations sur les classes Connection, consultez Connexion à des sources de données. Pour plus d'informations sur l'implémentation de fournisseurs de données .NET Framework, consultez Implementing a .NET Framework Data Provider.

Une application ne crée pas directement d'instance de l'interface IDbConnection, mais crée une instance d'une classe qui hérite de IDbConnection.

Les classes qui héritent de IDbConnection doivent implémenter tous les membres hérités et définissent généralement des membres supplémentaires pour ajouter des fonctionnalités propres au fournisseur. Par exemple, l'interface IDbConnection définit la propriété ConnectionTimeout. À son tour, la classe SqlConnection hérite de cette propriété et définit également la propriété PacketSize.

Remarques à l'attention des implémenteurs Pour promouvoir la cohérence entre les fournisseurs de données .NET Framework, nommez la classe qui hérite sous la forme PrvClassname où Prv est le préfixe uniforme affecté à toutes les classes d'un espace de noms de fournisseurs de données .NET Framework spécifique. Par exemple, Sql est le préfixe de la classe SqlConnection dans l'espace de noms System.Data.SqlClient. Si vous héritez de l'interface IDbConnection, il est recommandé d'implémenter les constructeurs suivants :

L'exemple suivant crée des instances des classes dérivées (SqlCommand et SqlConnection). SqlConnection est ouvert et défini comme Connection pour SqlCommand. L'exemple appelle ensuite ExecuteNonQuery et ferme la connexion. Pour effectuer cette opération, une chaîne de connexion et une chaîne de requête qui est une instruction Transact-SQL INSERT sont passées à ExecuteNonQuery.

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' 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);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

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 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

.NET Compact Framework