Exercice - Créer, générer et exécuter votre application

Effectué

Le SDK .NET comprend une interface de ligne de commande (CLI) accessible à partir du terminal intégré de Visual Studio Code. Au cours de cette formation, vous utilisez des commandes CLI .NET pour créer des applications console, générer votre code de projet et exécuter vos applications.

Par exemple, la commande CLI .NET suivante crée une application console à l’emplacement de dossier spécifié :

dotnet new console -o ./CsharpProjects/TestProject

La structure d’une commande CLI se compose des trois parties suivantes :

  • Le pilote : dotnet dans cet exemple.
  • La commande : new console dans cet exemple.
  • Les arguments de commande : -o ./CsharpProjects/TestProject dans cet exemple.

Notes

Les arguments de commande sont des paramètres facultatifs qui peuvent être utilisés pour fournir des informations supplémentaires. La commande précédente pourrait être exécutée sans spécifier l’emplacement de dossier facultatif. Par exemple : dotnet new console. Dans ce cas, l’application console serait créée à l’emplacement du dossier actif.

Dans cet exercice, vous utilisez Visual Studio Code pour créer un dossier de projet, créer une application console avec une commande CLI, personnaliser l’application dans Visual Studio Code Editor, puis générer et exécuter votre application.

Créer une application console C# dans un dossier spécifié

Pour commencer, vous créez une application console dans un emplacement de dossier facile à trouver et à réutiliser.

  1. Vérifiez que Visual Studio Code est ouvert.

    Vous pouvez utiliser le menu Démarrer de Windows pour rechercher et ouvrir Visual Studio Code.

  2. Dans Visual Studio Code, dans le menu Fichier, sélectionnez Ouvrir un dossier.

    Une boîte de dialogue Ouvrir un dossier s’affiche. Vous pouvez utiliser la boîte de dialogue Ouvrir un dossier afin de créer un dossier pour votre projet C#.

    Notes

    Si vous travaillez sur votre ordinateur personnel et que vous disposez d’un emplacement de dossier que vous utilisez pour vos projets de développement, vous pouvez utiliser la boîte de dialogue Ouvrir un dossier afin d’accéder à l’emplacement de dossier souhaité.

  3. Dans la boîte de dialogue Ouvrir un dossier, accédez au dossier Bureau Windows.

    Si vous conservez vos projets de code dans un autre dossier, vous pouvez utiliser cet emplacement à la place. Pour cette formation, l’important est d’avoir un emplacement facile à localiser et à mémoriser.

  4. Dans la boîte de dialogue Ouvrir un dossier, sélectionnez Sélectionner un dossier.

    Si une boîte de dialogue de sécurité vous demande si vous faites confiance aux auteurs, sélectionnez Oui.

  5. Dans le menu Terminal de Visual Studio Code, sélectionnez Nouveau Terminal.

    Capture d’écran montrant l’invite de commandes dans le panneau du terminal de Visual Studio Code.

    Notez qu’une invite de commandes dans le panneau Terminal affiche le chemin du dossier actif. Par exemple :

    C:\Users\someuser\Desktop>
    
  6. À l’invite de commandes du Terminal pour créer une application console dans un dossier spécifié, tapez la commande suivante :

    dotnet new console -o ./CsharpProjects/TestProject
    

    Capture d’écran montrant une commande entrée dans le panneau du terminal de Visual Studio Code.

    Cette commande CLI .NET utilise un modèle de programme .NET pour créer un projet d’application console C# à l’emplacement du dossier spécifié. La commande crée les dossiers CsharpProjects et TestProject automatiquement, et utilise TestProject comme nom pour votre fichier .csproj.

  7. Dans l’affichage EXPLORATEUR, développez le dossier CsharpProjects .

    Vous devriez voir le dossier TestProject et deux fichiers, un fichier programme C# nommé Program.cs et un fichier projet C# nommé TestProject.csproj. La commande CLI utilise le nom du dossier quand elle crée le fichier projet (TestProject.csproj). Le fichier Program.cs est le fichier contenant votre code C#.

  8. Dans l’affichage EXPLORATEUR, pour afficher le code C# dans le panneau Éditeur, sélectionnez Program.cs.

    Comme vous pouvez le voir, l’application console par défaut est l’application classique « Hello World! ». application Aha!.

    // See https://aka.ms/new-console-template for more information
    Console.WriteLine("Hello, World!");
    

    Cette application utilise la méthode Console.WriteLine() pour afficher « Hello, World! » dans la fenêtre de console.

Mettre à jour, générer et exécuter votre application

Dans cette tâche, vous utilisez la vue EXPLORATEUR pour ouvrir votre dossier de projet de code, personnaliser votre message « Hello », puis exécuter votre application.

  1. Dans la vue EXPLORATEUR de Visual Studio Code, cliquez avec le bouton droit sur TestProject, puis sélectionnez Ouvrir dans le Terminal intégré.

    Capture d’écran montrant une commande entrée dans le panneau du terminal intégré de Visual Studio Code.

    Important

    L’invite de commandes dans le panneau du terminal intégré indique l’emplacement du dossier où la commande s’exécutera. Avant d’exécuter une commande build ou run, vous devez vous assurer que le terminal est ouvert dans votre dossier de projet.

  2. Vérifiez que l’invite de commandes dans le panneau Terminal affiche le chemin d’accès au dossier suivant :

    C:\Users\someuser\Desktop\CsharpProjects\TestProject>
    
  3. Dans l’Éditeur Visual Studio Code, mettez à jour la méthode Console.WriteLine() comme suit :

    Console.WriteLine("Hello C#!");
    

    La première fois que vous modifiez un fichier .cs, Visual Studio Code peut vous inviter à ajouter les ressources manquantes pour générer et déboguer votre application. Si l’invite s’affiche, vous pouvez sélectionner Oui.

  4. Dans le menu Fichier, sélectionnez Enregistrer.

    Vous devez toujours enregistrer vos modifications de code dans le fichier. Les modifications de code que vous avez apportées dans l’Éditeur ne sont pas reconnues par le compilateur de code tant que le code n’est pas enregistré.

  5. Pour compiler une build de votre application, entrez la commande suivante à l’invite de commandes dans le terminal :

    dotnet build
    

    Capture d’écran montrant la commande dotnet build entrée dans le panneau du terminal de Visual Studio Code.

    La commande dotnet build génère le projet et ses dépendances dans un ensemble de fichiers binaires. Les composants binaires incluent le code du projet dans des fichiers de langage intermédiaire (IL) .dll. Selon le type de projet et les paramètres, d’autres fichiers peuvent également être inclus. Si vous êtes curieux, vous trouverez le fichier TestProject.dll dans l’affichage EXPLORATEUR à un emplacement de dossier similaire au chemin suivant :

    C:\Users\someuser\Desktop\CsharpProjects\TestProject\bin\Debug\net7.0\

    Notes

    Le chemin de votre dossier reflète votre compte et le chemin du dossier TestProject.

  6. Pour exécuter votre application, entrez la commande suivante à l’invite de commandes du terminal :

    dotnet run
    

    La commande dotnet run exécute le code source sans commandes explicites de compilation ou de démarrage. Elle fournit une option pratique pour exécuter votre application à partir du code source avec une seule commande. Elle est utile pour le développement itératif rapide en ligne de commande. La commande dépend de la commande dotnet build pour générer le code.

  7. Notez que Hello C# s’affiche dans le panneau Terminal sur la ligne sous la commande dotnet run.

    Si « Hello, World! » s’affiche, vérifiez que vous avez enregistré vos modifications de code.

Félicitations, vous avez mené à bien la configuration de Visual Studio Code ainsi que la génération et l’exécution d’une ligne de code simple !