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

Article
01/05/2025

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

Visual Studio Code avec l'extension C# Dev Kit installée.

Pour plus d’informations sur l’installation d’extensions sur Visual Studio Code, consultez Place de marché des extensions VS Code.
kit de développement logiciel (SDK) .NET 9.

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