Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
IDbConnection, interface
Collapse the table of content
Expand the table of content
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

IDbConnection, interface

Représente une connexion ouverte à une source de données, et est implémenté par les fournisseurs de données .NET Framework qui accèdent à des bases de données relationnelles.

Espace de noms :  System.Data
Assembly :  System.Data (dans System.Data.dll)

public interface IDbConnection : IDisposable

Le type IDbConnection expose les membres suivants.

  NomDescription
Propriété publiquePris en charge par XNA FrameworkConnectionStringObtient ou définit la chaîne utilisée pour ouvrir une base de données.
Propriété publiquePris en charge par XNA FrameworkConnectionTimeoutObtient la durée d'attente préalable à l'établissement d'une connexion avant que la tentative ne soit abandonnée et qu'une erreur ne soit générée.
Propriété publiquePris en charge par XNA FrameworkDatabaseObtient le nom de la base de données active ou de la base de données à utiliser une fois la connexion ouverte.
Propriété publiquePris en charge par XNA FrameworkStateObtient l'état actuel de la connexion.
Début

  NomDescription
Méthode publiquePris en charge par XNA FrameworkBeginTransaction()Commence une transaction de base de données.
Méthode publiquePris en charge par XNA FrameworkBeginTransaction(IsolationLevel)Commence une transaction de base de données avec la valeur IsolationLevel spécifiée.
Méthode publiquePris en charge par XNA FrameworkChangeDatabaseModifie la base de données active d'un objet Connection ouvert.
Méthode publiquePris en charge par XNA FrameworkCloseFerme la connexion à la base de données.
Méthode publiquePris en charge par XNA FrameworkCreateCommandCrée et retourne un objet Command associé à la connexion.
Méthode publiquePris en charge par XNA FrameworkDisposeExécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de IDisposable.)
Méthode publiquePris en charge par XNA FrameworkOpenOuvre une connexion de base de données à l'aide des paramètres spécifiés par la propriété ConnectionString de l'objet Connection propre au fournisseur.
Début

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 à une source de données.

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 PrvClassnamePrv 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ément

Description

PrvConnection()

Initialise une nouvelle instance de la classe PrvConnection.

PrvConnection(string connectionString)

Initialise une nouvelle instance de la classe PrvConnection en fonction d'une chaîne contenant la chaîne de connexion.

L'exemple suivant crée des instances des classes dérivées (SqlCommand et SqlConnection). SqlConnection est ouvert et défini en tant que 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.


using System;
using System.Data;

namespace IDbConnectionSample {
   class Program {
      static void Main(string[] args) {
         IDbConnection connection;

         // First use a SqlClient connection
         connection = new System.Data.SqlClient.SqlConnection(@"Server=(localdb)\V11.0");
         Console.WriteLine("SqlClient\r\n{0}", GetServerVersion(connection));
         connection = new System.Data.SqlClient.SqlConnection(@"Server=(local);Integrated Security=true");
         Console.WriteLine("SqlClient\r\n{0}", GetServerVersion(connection));

         // Call the same method using ODBC
         // NOTE: LocalDB requires the SQL Server 2012 Native Client ODBC driver
         connection = new System.Data.Odbc.OdbcConnection(@"Driver={SQL Server Native Client 11.0};Server=(localdb)\v11.0");
         Console.WriteLine("ODBC\r\n{0}", GetServerVersion(connection));
         connection = new System.Data.Odbc.OdbcConnection(@"Driver={SQL Server Native Client 11.0};Server=(local);Trusted_Connection=yes");
         Console.WriteLine("ODBC\r\n{0}", GetServerVersion(connection));

         // Call the same method using OLE DB
         connection = new System.Data.OleDb.OleDbConnection(@"Provider=SQLNCLI11;Server=(localdb)\v11.0;Trusted_Connection=yes;");
         Console.WriteLine("OLE DB\r\n{0}", GetServerVersion(connection));
         connection = new System.Data.OleDb.OleDbConnection(@"Provider=SQLNCLI11;Server=(local);Trusted_Connection=yes;");
         Console.WriteLine("OLE DB\r\n{0}", GetServerVersion(connection));
         }

      public static string GetServerVersion(IDbConnection connection) {
         // Ensure that the connection is opened (otherwise executing the command will fail)
         ConnectionState originalState = connection.State;
         if (originalState != ConnectionState.Open)
            connection.Open();
         try {
            // Create a command to get the server version
            // NOTE: The query's syntax is SQL Server specific
            IDbCommand command = connection.CreateCommand();
            command.CommandText = "SELECT @@version";
            return (string)command.ExecuteScalar();
         }
         finally {
            // Close the connection if that's how we got it
            if (originalState == ConnectionState.Closed)
               connection.Close();
         }
      }
   }
}


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft