Les classes

C# étant un langage objet, il permet de créer des classes.

Classe

Documentation officielle

Une classe est un modèle pour créer des objets. Elle peut contenir des champs, des propriétés, des méthodes, des événements, des indexeurs, des opérateurs, des constructeurs et des destructeurs.

public class MaClasse
{
    int _valeur;
    public MaClasse(int valeur) {
        _valeur = valeur
    }
}

// Pour l'instancier
MaClasse c = new MaClasse(0);

Constructeur

Une classe peut avoir un ou plusieurs constructeurs. Si aucun constructeur n'est implémenté, un constructeur par défaut (vide) sera automatiquement fourni.

public class MaClasse
{
    int _valeur;
    public MaClasse(int valeur) {
        _valeur = valeur;
    }

    public MaClasse() {
        _valeur = 0;
    }

    public MaClasse(int valeur) {
        _valeur = valeur;
    }
}

Depuis la version C# 12 il est possible de définir le constructeur directement après le nom de la classe :

public class MaClasse(int valeur)
{
    int _valeur = valeur;
}

Destructeur

Doumentation officielle

Il est possible de définir un destructeur pour une classe. Celui-ci est appelé lorsque l'instance de la classe est détruite.

public class MaClasse
{
    ~MaClasse()
    {
        Console.WriteLine("Destruction de l'instance");
    }
}

Surcharge / Override

Il est possible de surcharger des méthodes. Surcharger une méthode permet de redéfinir son comportement.

Pour surcharger une méthode, il faut qu'elle soit déclarée dans la classe parente avec le mot clé virtual.

Toutes les classes C# héritent de la classe Object qui contient trois méthodes virtuelles principales :

• ToString : Permet de retourner une chaine de caractères représentant l'objet.
• Equals : Permet de comparer deux objets.
• GetHashCode : Permet de retourner un code de hachage pour l'objet.

toString

Lorsque vous affichez une instance d'une classe dans la console, elle vous renvoie par défaut le nom complet de la classe : Namespace.Classe.

Voici a quoi ressemble la méthode ToString de la classe Object.

public virtual string? ToString() => this.GetType().ToString();

Vous pouvez surcharger la méthode toString pour choisir quoi afficher.

public class User
{
    public int Id { get; set; }
    public string? Name { get; set;}
    public string? Email { get; set;}
    public string? PasswordHash { get; set; }

    // Notez la présence de override qui précise que cette méthode existe deja et que l'on la surcharge
    public override string ToString()
    {
        return $"Id: ${Id} Name: ${Name} Email : ${Email} Pass: ${PasswordHash}";
    }
}

User u = new User():
u.Id = 0;
u.Name = "abc";
u.Email = "a@b.c";
u.PasswordHash = "";

Console.WriteLine(u);
// Affichera
// Id: 0 Name: abc Email : a@b.c Pass: 

C'est très pratique pour déboguer le contenu d'une classe.

Constructeur primaire

Documentation officielle

Depuis la version 12 de C#, il est possible de définir un constructeur primaire.

Ce constructeur permet de définir les propriétés de la classe directement dans la déclaration de celle-ci.

public class User(int id, string name, string email, string passwordHash)
{
    public int Id { get; set; } = id;
    public string Name { get; set; } = name;
    public string Email { get; set; } = email;
    public string PasswordHash { get; set; } = passwordHash;
}

Vous pouvez également combiner un constructeur primaire avec un constructeur classique. Lorsque vous utilisez un constructeur primaire, vous pouvez l'appeler dans un autre constructeur en utilisant le mot clé this pour appeler le constructeur primaire.

public class User(int id, string name, string email, string passwordHash)
{
    public int Id { get; set; } = id;
    public string Name { get; set; } = name;
    public string Email { get; set; } = email;
    public string PasswordHash { get; set; } = passwordHash;

    public User(string name, string email, string passwordHash): this(0, name, email, passwordHash) {}
}