Chapprend · BTS 2 · C#

7 · SQL Server : lire et écrire sans concaténation

Construire un petit accès aux utilisateurs avec paramètres typés et gestion explicite des résultats.

Un schéma cohérent pour tout l’exemple

Le TP d’origine introduit lecture et ajout de clients. On réorganise ici le même principe avec les noms du TP en couches, pour pouvoir réutiliser le code ensuite. Dans une base d’exercice vide, créer une seule fois :

sql
CREATE TABLE dbo.T_Identification
(
    Id_utilisateur int IDENTITY(1,1) PRIMARY KEY,
    Nom_utilisateur nvarchar(50) NOT NULL
);

Aucune instruction ne supprime une base existante. IDENTITY génère la clé ; NOT NULL interdit l’absence de nom, mais n’interdit pas une chaîne vide. Le contrôle métier reste nécessaire.

Avec le package et la configuration de la fiche 6, créer ce modèle partagé :

csharp
public class Utilisateur
{
    public int Id { get; }
    public string Nom { get; }

    public Utilisateur(int id, string nom)
    {
        Id = id;
        Nom = nom;
    }
}

Lire les lignes avec un DAO

Un DAO (Data Access Object) regroupe les opérations de stockage. Créer UtilisateurDAO.cs avec cette classe :

csharp
using System;
using System.Collections.Generic;
using System.Data;
using Microsoft.Data.SqlClient;

public class UtilisateurDAO
{
    private readonly string chaineConnexion;

    public UtilisateurDAO(string chaineConnexion)
    {
        if (string.IsNullOrWhiteSpace(chaineConnexion))
            throw new ArgumentException("Configuration SQL obligatoire");
        this.chaineConnexion = chaineConnexion;
    }

    public List<Utilisateur> Lister()
    {
        var utilisateurs = new List<Utilisateur>();
        using (var connexion = new SqlConnection(chaineConnexion))
        using (var commande = new SqlCommand(
            "SELECT Id_utilisateur, Nom_utilisateur FROM dbo.T_Identification ORDER BY Id_utilisateur",
            connexion))
        {
            connexion.Open();
            using (var lecteur = commande.ExecuteReader())
            {
                while (lecteur.Read())
                {
                    utilisateurs.Add(new Utilisateur(
                        lecteur.GetInt32(0), lecteur.GetString(1)));
                }
            }
        }
        return utilisateurs;
    }
}

Les colonnes sont nommées explicitement : leurs positions 0 et 1 correspondent aux getters. Read() renvoie false si aucune ligne n’existe : le résultat est alors une liste vide, pas une erreur. La liste est construite avant de fermer le lecteur et peut ensuite être utilisée par l’interface.

Ajouter avec un paramètre et récupérer la clé

Ajouter cette méthode dans la même classe :

csharp
public int Ajouter(string nom)
{
    if (string.IsNullOrWhiteSpace(nom) || nom.Trim().Length > 50)
        throw new ArgumentException("Nom requis, limité à 50 caractères.");

    using (var connexion = new SqlConnection(chaineConnexion))
    using (var commande = new SqlCommand(
        "INSERT INTO dbo.T_Identification (Nom_utilisateur) OUTPUT INSERTED.Id_utilisateur VALUES (@nom)",
        connexion))
    {
        commande.Parameters.Add("@nom", SqlDbType.NVarChar, 50).Value = nom.Trim();
        connexion.Open();
        return Convert.ToInt32(commande.ExecuteScalar());
    }
}

Le texte SQL contient @nom, pas la saisie concaténée. Le paramètre transporte une valeur ; un nom contenant une apostrophe reste une donnée. Le type et la taille correspondent au schéma. OUTPUT INSERTED.Id_utilisateur permet de récupérer la clé générée ; ExecuteNonQuery() seul ne la donnerait pas.

À retenir

Un paramètre protège une valeur, pas un nom de table ou de colonne. Pour un tri dynamique, choisir une colonne dans une liste autorisée, jamais depuis une chaîne libre.

Modifier, supprimer et vérifier

Pour renommer, la commande utilise UPDATE dbo.T_Identification SET Nom_utilisateur = @nom WHERE Id_utilisateur = @id. Pour supprimer : DELETE FROM dbo.T_Identification WHERE Id_utilisateur = @id. Fournir @id avec SqlDbType.Int et exécuter avec ExecuteNonQuery(). Sans clause WHERE, toutes les lignes peuvent être touchées.

Dans cette table simple sans déclencheur, zéro ligne affectée indique que l’identifiant n’a pas été trouvé ; ne pas annoncer systématiquement une réussite. Demander confirmation dans l’interface avant une suppression. Pour plusieurs écritures qui doivent réussir ensemble, utiliser une transaction commune et son rollback en cas d’échec.

Jeux d’essai : liste vide ; nom normal ; apostrophe ; nom vide ; 50 puis 51 caractères ; identifiant absent ; serveur indisponible. Relire depuis la base après l’ajout, puis redémarrer l’application pour distinguer mémoire et persistance.

Pourquoi ajouter une validation de longueur alors que SQL impose nvarchar(50) ?

Pour expliquer l’erreur avant l’envoi et éviter une troncature ou un échec technique. Le schéma constitue une deuxième barrière, pas l’interface utilisateur.