Construire un projet de bibliothèque de classes C# - Perspectives de la leçon de Tim Corey

Dans cette leçon, Tim Corey nous guide à travers le processus pratique de création d'une bibliothèque de classes C#, nous emmenant de la planification au code réel. Tim souligne que la planification est essentielle, mais une fois la planification terminée, il est temps de commencer à construire.

Dans cet article, nous suivrons l'approche exacte et le raisonnement de Tim, étape par étape, pour comprendre comment une bibliothèque de classes est créée, organisée et documentée dans Visual Studio.

Démarrer la bibliothèque de classes dans Visual Studio

Tim commence en disant qu'ils ont été bloqués en mode planification pendant un moment, mais maintenant ils sont enfin prêts à coder. Il ouvre Visual Studio et choisit "Créer un nouveau projet", puis sélectionne "Bibliothèque de classes". Tim la nomme TrackerLibrary et définit le nom de la solution sur TournamentTracker.

La première action de Tim à l'intérieur de la nouvelle bibliothèque est de supprimer le Class1.cs par défaut, expliquant qu'il ne veut aucun fichier par défaut ou mal nommé dans son projet. Il dit que le renommage peut causer des problèmes, alors il le supprime entièrement pour éviter des problèmes plus tard.

Transformer la planification en code — Ajout de classes

Tim explique que le véritable avantage de la planification est que, une fois que vous êtes prêt à coder, vous ne devinez pas quelles données vous avez besoin. Au lieu de cela, vous transférez simplement le design planifié en code réel.

Il mentionne qu'à ce stade, vous ne pensez pas aux données requises, mais plutôt vous vérifiez les noms, les structures, et si quelque chose manque. Tim dit que c'est pourquoi la planification accélère considérablement le processus de codage.

Créer le modèle d'équipe

Tim ajoute la première classe : TeamModel. Il explique qu'il pourrait la nommer simplement Équipe, mais il préfère ajouter Modèle à la fin pour l'identifier clairement comme un modèle de données.

Il utilise l'extrait prop de Visual Studio pour générer rapidement des propriétés. Tim crée les propriétés suivantes :

• List<PersonModel> MembresÉquipe

• string NomÉquipe

Tim explique également un point clé : il veut que TeamMembers soit initialisé automatiquement afin que la liste ne soit jamais nulle. Il démontre deux approches :

1. Avant C# 6.0 :
   Utilisez un constructeur pour initialiser la liste.

2. Depuis C# 6.0 :
   Initialisez directement dans la propriété en utilisant :

   public List<PersonModel> MembresÉquipe { get; set; } = new List<PersonModel>();

   Text

Tim préfère l'approche moderne car elle simplifie le code.

Créer le modèle de personne

Ensuite, Tim crée PersonModel. En utilisant l'extrait prop, il ajoute rapidement des propriétés :

• chaîne Prénom

• chaîne Nom

• string AdresseEmail

• string NuméroTéléphonePortable

Tim souligne à quel point il est rapide de construire des modèles lorsque la planification est déjà faite. Il nous rappelle également que le code est maintenant directement basé sur le document de planification.

Créer le modèle de tournoi

Tim ajoute le TournamentModel, qui inclut :

• string NomTournoi

• decimal FraisInscription

• List<TeamModel> ÉquipesEngagées

• List<PrizeModel> Prix

• List<List<MatchupModel>> Tours

Il souligne comment C# comprend des structures de listes complexes comme List<List<MatchupModel>> et remplit même automatiquement le type lors de l'utilisation de new.

Ajout du modèle de prix

Tim ajoute PrizeModel avec les propriétés suivantes :

• int NuméroPlace

• string NomPlace

• decimal MontantPrix

• double PourcentagePrix

Il indique que ces valeurs sont pour l'instant laissées avec des valeurs par défaut et peuvent être modifiées ultérieurement si nécessaire.

Création de modèles de confrontation

Tim ajoute MatchupModel, incluant :

• List<MatchupEntryModel> Entrées

• TeamModel Gagnant

• int TourRencontre

Il s'assure également que la liste Entries est initialisée automatiquement, comme il l'a fait précédemment.

Puis Tim ajoute MatchupEntryModel, qui inclut :

• TeamModel ÉquipeConcourante

• double Score

• MatchupModel RencontreParente

Tim souligne que ces modèles complètent la fondation de la bibliothèque de classes.

La bibliothèque de classes est simple une fois planifiée

Tim dit qu'une fois la planification terminée, construire la bibliothèque de classes devient très simple. Il souligne que la structure de la bibliothèque est simple car tout le travail de conception a déjà été complété.

Il nous rappelle que le principal avantage de la planification est que le codage devient rapide et propre.

Ajouter des commentaires XML — Pourquoi cela compte

Tim souligne que l'étape finale devrait être la documentation du code, en particulier en utilisant des commentaires XML. Il admet que commenter est fastidieux mais avertit que si vous ne le faites pas maintenant, vous ne le ferez probablement pas plus tard.

Il montre comment créer des commentaires XML en tapant trois barres obliques (///) au-dessus d'une propriété. Tim montre comment écrire des descriptions telles que :

• " Représente une équipe dans la confrontation "

• " Représente le score pour cette équipe particulière "

• " Représente la confrontation dont cette équipe vient en tant que vainqueur "

Tim explique que les commentaires XML ne sont pas seulement des commentaires formatés — ils deviennent une partie de la documentation de code et aident d'autres développeurs à comprendre vos classes.

Les commentaires XML améliorent l'utilisabilité du code

Tim démontre comment les commentaires XML fonctionnent avec IntelliSense. Il crée un constructeur et ajoute des commentaires XML pour le paramètre, montrant que les commentaires apparaissent automatiquement dans IntelliSense.

Il compare cela à la description intégrée de Console.WriteLine() de Visual Studio, qui provient de la propre documentation XML de Microsoft. Tim explique qu'utiliser des commentaires XML vous permet de fournir le même niveau de clarté et d'utilisabilité dans votre propre bibliothèque de classes.

Encouragement final

Tim encourage les spectateurs à ajouter des commentaires XML au reste des modèles, même s'il ne montre pas le processus complet en raison de sa nature répétitive.

Il conclut en annonçant la prochaine leçon : créer des formulaires. Tim note que les formulaires conçus pendant la planification étaient de simples croquis, et qu'il est maintenant temps de les rendre plus modernes et fonctionnels.

Conclusion — La leçon de Tim en résumé

La leçon de Tim Corey montre que créer une bibliothèque de classes C# consiste à traduire la planification en code. Les étapes sont :

1. Créer le projet de bibliothèque de classes

2. Ajouter des modèles basés sur la planification

3. Initialiser des listes pour éviter les nulls

4. Documenter le code avec des commentaires XML

5. Se préparer à construire des formulaires

En suivant la méthode de Tim, vous construisez une bibliothèque de classes propre et bien structurée de manière efficace et professionnelle, prête à soutenir le reste de votre application.