Chapprend · BTS 2 · C#
6 · ADO.NET : connexion et commandes
Identifier les objets ADO.NET, configurer SQL Server et libérer correctement les ressources.
Quatre objets à distinguer
ADO.NET est une API .NET d’accès aux données. Le fournisseur implémente l’accès à un moteur donné : ici SQL Server, pas MySQL. Les anciens supports utilisent System.Data.SqlClient ; pour un nouveau projet, les exemples utilisent le package Microsoft.Data.SqlClient. Ne pas mélanger les types des deux fournisseurs.
| Objet | Rôle |
|---|---|
SqlConnection | Connexion logique à la base. |
SqlCommand | Requête ou procédure à exécuter. |
SqlParameter | Valeur typée transmise à la commande. |
SqlDataReader | Lecture successive des lignes retournées. |
Préparer l’environnement
Installer le package dans le projet contenant l’accès SQL avec dotnet add package Microsoft.Data.SqlClient. Il faut aussi un serveur SQL Server joignable, une base existante et un compte disposant des droits nécessaires. Le package n’installe pas le serveur.
La chaîne de connexion précise le serveur, Initial Catalog (ou Database) et l’authentification. Fournir sa valeur à l’application par une configuration non versionnée ; ici la variable d’environnement REVISION_SQLSERVER. Ne jamais mettre les identifiants dans une fiche publique, un dépôt ou un message d’erreur destiné à l’utilisateur.
Conserver le chiffrement et une validation de certificat correcte. Si la connexion échoue sur un certificat, corriger le certificat ou la confiance de l’environnement plutôt que désactiver systématiquement la protection.
Ouvrir, exécuter, libérer
using System;
using Microsoft.Data.SqlClient;
public static class Program
{
public static void Main()
{
string chaine = Environment.GetEnvironmentVariable("REVISION_SQLSERVER");
if (string.IsNullOrWhiteSpace(chaine))
throw new InvalidOperationException("Configuration SQL manquante.");
using (var connexion = new SqlConnection(chaine))
using (var commande = new SqlCommand("SELECT COUNT(*) FROM dbo.T_Identification", connexion))
{
connexion.Open();
int nombre = Convert.ToInt32(commande.ExecuteScalar());
Console.WriteLine(nombre);
}
}
}Cet exemple complet nécessite la table créée dans la fiche suivante. Construire SqlConnection ne l’ouvre pas ; Open() le fait. ExecuteScalar() lit la première colonne de la première ligne. Les blocs using libèrent la commande puis la connexion, même si une exception survient.
La fermeture rend généralement une connexion physique au pool pour réutilisation. Garder une connexion globale ouverte dans un singleton n’est pas nécessaire et complique les erreurs et la concurrence.
Choisir la bonne méthode et traiter l’échec
ExecuteReader(): plusieurs lignes à parcourir avecRead(). Le lecteur démarre avant la première ligne ; tester aussiIsDBNull()pour les colonnes SQL nullable.ExecuteNonQuery(): insertion, modification ou suppression ; renvoie un nombre de lignes affectées, pas un identifiant créé. Des déclencheurs ou NOCOUNT peuvent modifier la valeur rapportée.ExecuteScalar(): une valeur, par exemple un total ou un identifiant retourné explicitement par la requête.
Une erreur de connexion doit arrêter l’opération : ne pas afficher « connecté » ni continuer la lecture dans le même chemin. Intercepter l’erreur à une frontière adaptée, journaliser sans secret et afficher un message clair. En interface, préférer les variantes asynchrones pour les opérations longues.
Une connexion ouverte garantit-elle que la liste affichée se met à jour automatiquement ?
Non. Il faut exécuter une nouvelle lecture et actualiser la source de l’interface. ADO.NET ne transforme pas une liste en flux temps réel.