Tutoriel : Créer une bibliothèque de classes .NET à l’aide de Visual Studio Code

2025-04-03

Dans ce tutoriel, vous créez une bibliothèque utilitaire simple qui contient une méthode de gestion de chaîne unique.

Une bibliothèque de classes définit les types et méthodes appelés par une application. Si la bibliothèque cible .NET Standard 2.0, elle peut être appelée par n’importe quelle implémentation .NET (y compris .NET Framework) qui prend en charge .NET Standard 2.0. Si la bibliothèque cible .NET 9, elle peut être appelée par n’importe quelle application qui cible .NET 9. Ce tutoriel montre comment cibler .NET 9.

Lorsque vous créez une bibliothèque de classes, vous pouvez la distribuer en tant que composant tiers ou en tant que composant groupé avec une ou plusieurs applications.

Conditions préalables

La dernière version du SDK .NET
Éditeur de code Visual Studio
Le DevKit C#

Instructions d’installation

Sous Windows, ce fichier de configuration WinGet permet d'installer tous les prérequis. Si vous avez déjà installé quelque chose, WinGet ignore cette étape.

Téléchargez le fichier et double-cliquez pour l’exécuter.
Lisez le contrat de licence, tapez et, puis sélectionnez Entrer lorsque vous êtes invité à accepter.
Si vous recevez une invite de contrôle de compte d’utilisateur (UAC) qui clignote dans votre barre des tâches, autorisez la poursuite de l'installation.

Sur d’autres plateformes, vous devez installer chacun de ces composants séparément.

Téléchargez le programme d’installation recommandé à partir de la page de téléchargement sdk .NETet double-cliquez pour l’exécuter. La page de téléchargement détecte votre plateforme et recommande le dernier programme d’installation de votre plateforme.
Téléchargez le dernier programme d’installation à partir de la page d’accueil Visual Studio Code, puis double-cliquez pour l’exécuter. Cette page détecte également votre plateforme et le lien doit être correct pour votre système.
Cliquez sur le bouton « Installer » dans la page d’extension devKit C#. Cela ouvre Visual Studio Code et vous demande si vous souhaitez installer ou activer l’extension. Sélectionnez « installer ».

Créer un projet de bibliothèque de classes

Commencez par créer un projet de bibliothèque de classes .NET nommé « StringLibrary » et une solution associée. Une solution sert de conteneur pour un ou plusieurs projets. Vous allez ajouter des projets supplémentaires associés à la même solution.

Démarrez Visual Studio Code.
Accédez à l’affichage Explorateur et sélectionnez Créer un projet .NET. Vous pouvez également afficher la palette de commandes à l’aide de Ctrl+Maj+P (Commande+Maj+P sur MacOS), puis taper . NET », puis rechercher et sélectionner la commande .NET : Nouveau projet.
Après avoir sélectionné la commande, vous devez choisir le modèle de projet. Choisissez Bibliothèque de classes.
Sélectionnez ensuite l’emplacement où vous souhaitez que le nouveau projet soit créé.
Sélectionnez ensuite l’emplacement où vous souhaitez créer le nouveau projet : créez un dossier nommé ClassLibraryProjects et sélectionnez-le.
Nommez le projet StringLibrary, sélectionnez Afficher toutes les options de modèle, sélectionnez .NET 9 et sélectionnez Créer un projet.
Nommez le projet StringLibrary, puis sélectionnez Créer un projet.
Appuyez sur Entrée à l’invite, le projet sera créé dans <le chemin d'accès>.
Vérifiez que la bibliothèque cible .NET 9. Dans Explorateur, ouvrez StringLibrary/StringLibrary.csproj.

L’élément TargetFramework montre que le projet cible .NET 9.0.
```
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
  </PropertyGroup>

</Project>
```
Ouvrez Class1.cs et remplacez le code par le code suivant.
```
using System;

namespace UtilityLibraries
{
    public static class StringLibrary
    {
        public static bool StartsWithUpper(this string str)
        {
            if (string.IsNullOrWhiteSpace(str))
                return false;

            char ch = str[0];
            return char.IsUpper(ch);
        }
    }
}
```
La bibliothèque de classes, UtilityLibraries.StringLibrary, contient une méthode nommée StartsWithUpper. Cette méthode retourne une valeur Boolean qui indique si l’instance de chaîne actuelle commence par un caractère majuscule. La norme Unicode distingue les caractères majuscules des caractères minuscules. La méthode Char.IsUpper(Char) retourne true si un caractère est en majuscules.

StartsWithUpper est implémentée en tant que méthode d’extension pour pouvoir l’appeler comme s’il s’agissait d’un membre de la classe String.
Enregistrez le fichier.
Développez l’Explorateur de solutions en bas de la vue Explorateur.

Cliquez avec le bouton droit sur la solution dans Explorateur de solutions, puis sélectionnez Générer, ou ouvrez la palette de commandes, puis sélectionnez .NET : Générer pour générer la solution et vérifier que le projet se compile sans erreur.

La sortie du terminal ressemble à l’exemple suivant :

Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
Copyright (C) Microsoft Corporation. All rights reserved.
  Determining projects to restore...
  All projects are up-to-date for restore.
  StringLibrary -> C:\Projects\ClassLibraryProjects\StringLibrary\bin\Debug\net9.0\StringLibrary.dll
Build succeeded.
    0 Warning(s)
    0 Error(s)
Time Elapsed 00:00:02.78

Ajouter une application console à la solution

Ajoutez une application console qui utilise la bibliothèque de classes. L’application invite l’utilisateur à entrer une chaîne et à signaler si la chaîne commence par un caractère majuscule.

Cliquez avec le bouton droit sur la solution dans Explorateur de solutions, puis sélectionnez nouveau projet, ou dans la palette de commandes, sélectionnez .NET : Nouveau projet.
Sélectionnez l’application console.
Attribuez-lui le nom ShowCase, sélectionnez l’emplacement par défaut, puis sélectionnez Créer un projet.

Ouvrez ShowCase/Program.cs et remplacez tout le code par le code suivant.

using System;
using UtilityLibraries;

class Program
{
    static void Main(string[] args)
    {
        int row = 0;

        do
        {
            if (row == 0 || row >= 25)
                ResetConsole();

            string? input = Console.ReadLine();
            if (string.IsNullOrEmpty(input)) break;
            Console.WriteLine($"Input: {input} {"Begins with uppercase? ",30}: " +
                              $"{(input.StartsWithUpper() ? "Yes" : "No")}{Environment.NewLine}");
            row += 3;
        } while (true);
        return;

        // Declare a ResetConsole local method
        void ResetConsole()
        {
            if (row > 0)
            {
                Console.WriteLine("Press any key to continue...");
                Console.ReadKey();
            }
            Console.Clear();
            Console.WriteLine($"{Environment.NewLine}Press <Enter> only to exit; otherwise, enter a string and press <Enter>:{Environment.NewLine}");
            row = 3;
        }
    }
}

Le code utilise la variable row pour conserver le nombre de lignes de données écrites dans la fenêtre de console. Chaque fois qu’il est supérieur ou égal à 25, le code efface la fenêtre de console et affiche un message à l’utilisateur.

Le programme invite l’utilisateur à entrer une chaîne. Elle indique si la chaîne commence par un caractère majuscule. Si l’utilisateur appuie sur l'Entrée touche sans entrer de chaîne, l’application se termine et la fenêtre de console se ferme.

Enregistrez vos modifications.

Ajouter une référence de projet

Initialement, le nouveau projet d’application console n’a pas accès à la bibliothèque de classes. Pour lui permettre d’appeler des méthodes dans la bibliothèque de classes, créez une référence de projet au projet de bibliothèque de classes.

Dans l’Explorateur de solutions , cliquez avec le bouton droit sur le projet ShowCase et sélectionnez Ajouter une référence de projet.
Sélectionnez StringLibrary.

Exécuter l’application

Sélectionnez Exécuter>Exécuter sans déboguer.
Sélectionnez C#.
Sélectionnez ShowCase.

Si vous obtenez une erreur indiquant qu’aucun programme C# n’est chargé, fermez le dossier que vous avez ouvert et ouvrez le dossier ShowCase. Réessayez ensuite d’exécuter l’application.

Essayez le programme en entrant des chaînes et en appuyant sur Entrée, puis appuyez sur Entrée pour quitter.

La sortie du terminal ressemble à l’exemple suivant :

Press <Enter> only to exit; otherwise, enter a string and press <Enter>:

A string that starts with an uppercase letter
Input: A string that starts with an uppercase letter
Begins with uppercase? : Yes

a string that starts with a lowercase letter
Input: a string that starts with a lowercase letter
Begins with uppercase? : No

Ressources additionnelles

Étapes suivantes

Dans ce tutoriel, vous avez créé un projet de bibliothèque et ajouté un projet d’application console qui utilise la bibliothèque. Dans le tutoriel suivant, vous ajoutez un projet de test unitaire à la solution.

Tester une bibliothèque de classes .NET avec .NET à l’aide de Visual Studio Code

Partager via