Démarrage rapide : Déboguer ASP.NET Core avec le débogueur Visual Studio

Dans ce guide de démarrage rapide, vous allez découvrir comment utiliser le débogueur Visual Studio pour déboguer votre code d’application ASP.NET Core. Cet article fournit un moyen rapide d’apprendre quelques-unes des fonctionnalités de base pour travailler dans le débogueur.

Si vous n'avez pas Visual Studio, vous pouvez installer la version d'évaluation free version à partir de la page téléchargements Visual Studio.

Créer un projet

Commencez par créer un nouveau projet afin d’avoir du code à examiner avec le débogueur.

  1. Ouvrez Visual Studio et créez un projet.

    • Si la fenêtre de démarrage n’est pas ouverte, sélectionnez Fichier>Fenêtre de démarrage.

    • Dans la fenêtre de démarrage, sélectionnez Créer un projet.

  2. Dans la fenêtre Créer un projet , définissez les filtres et recherchez un modèle de projet.

    • Dans la zone Rechercher des modèles , entrez l’application web.

    • Développez la liste déroulante Langue et sélectionnez C#.

  3. Dans la liste des résultats, sélectionnez le modèle ASP.NET Core Web App (Pages Razor) pour C#, puis sélectionnez Next.

    Si vous ne voyez pas le modèle ASP.NET Core Web App (Pages Razor) pour C#, sélectionnez l'option Continue sans code option.

    1. Sélectionnez Tools>Get Tools and Features... , qui ouvre le programme d’installation Visual Studio.

    2. Dans la fenêtre Programme d’installation, cochez la case correspondant à la charge de travail ASP.NET et développement web, puis sélectionnez Modifier.

      Vos mises à jour d’installation Visual Studio pour inclure la charge de travail ASP.NET sélectionnée.

    3. Une fois la mise à jour terminée, sélectionnezFenêtre de démarrage du > et suivez les instructions précédentes pour sélectionner le modèle requis.

  4. Configurez le nouveau projet :

    1. Entrez un nom Project et Solution ou utilisez les valeurs par défaut.

    2. Utilisez l’emplacement par défaut ou sélectionnez Parcourir (...) pour créer le projet dans un autre dossier.

    3. Sélectionnez Suivant.

    4. Utilisez l’infrastructure cible recommandée (la valeur par défaut est .NET 10.0 Long Term Support).

    5. Pour les autres paramètres, utilisez les valeurs par défaut.

    6. Cliquez sur Créer.

    Visual Studio crée votre projet et ajoute les fichiers projet dans le dossier spécifié.

Mettre à jour le code du projet

Mettez à jour certains du code fourni par le modèle de projet afin que vous ayez plus d’instructions à tester dans le débogueur.

  1. Dans le volet Explorateur de solutions, développez le nœud <project-name>\Pages, puis sélectionnez l’élément Privacy.cshtml.

    Le fichier Privacy.cshtml s’ouvre dans l’éditeur de code.

  2. Recherchez la section de code suivante dans le fichier et remplacez-la par l’extrait de code fourni :

    @{
 ViewData["Title"] = "Privacy Policy";
}

    Fragment de remplacement :

    @{
 ViewData["Title"] = "Privacy Policy";
 <label>@PrivacyModel.PrivacyMessage</label>
}

  3. Dans Explorateur de solutions, développez le nœud <project-name>\Pages\Privacy.cshtml, puis sélectionnez l’élément Privacy.cshtml.cs.

    Le fichier Privacy.cshtml.cs s’ouvre dans l’éditeur de code.

  4. Recherchez la section de code suivante dans le fichier et remplacez-la par l’extrait de code fourni :

    public void OnGet()
{
}

    Extrait de code de remplacement :

    
public static string? PrivacyMessage { get; set; }

public void OnGet() {
   LinkedList<int> result = DoWork();

   PrivacyMessage = "Result of work: " + result.First.Value + ", " + result.First.Value;
}

private static LinkedList<int> DoWork() {
   LinkedList<int> c1 = new();

   c1.AddLast(10);
   c1.AddLast(20);

   LinkedList<int> c2 = new(c1);
   return c2;
}

Définir un point d’arrêt

Un point d’arrêt est un marqueur qui indique où Visual Studio doit interrompre l’exécution de votre code. Lorsqu’un point d’arrêt est défini, vous pouvez examiner les valeurs actuelles des variables, examiner le comportement de la mémoire et vérifier si une branche spécifique de code est en cours d’exécution. Les points d’arrêt sont la fonctionnalité la plus simple du débogage.

  1. Pour placer un point d’arrêt, repérez l’appel à DoWork dans le code, puis sélectionnez la marge de gauche sur la même ligne.

    Lorsque le point d’arrêt est défini, un point rouge s’affiche dans la barre gauche de la ligne correspondante dans le code.

    Screenshot qui montre comment définir un point d’arrêt dans le débogueur Visual Studio.

    Screenshot qui montre comment définir un point d’arrêt dans le débogueur Visual Studio 2022.

  2. Démarrez le débogage à l’aide du raccourci clavier F5 (ou sélectionnez Démarrer> ledébogage).

  3. Lorsque la page web s’ouvre dans la fenêtre du navigateur, sélectionnez le lien Confidentialité en haut de la page.

    L’exécution du code s’interrompt immédiatement avant l’appel à la DoWork fonction.

    Le débogueur s'interrompt à l'endroit où vous avez défini le point d'arrêt. Une flèche jaune identifie l’instruction où le débogueur interrompt l’exécution de l’application.

    Capture d’écran montrant le débogueur arrêté à un point d’arrêt défini dans Visual Studio.

    Capture d’écran montrant le débogueur arrêté sur un point d’arrêt défini dans Visual Studio 2022.

Définir des points d’arrêt conditionnels

Si vous définissez un point d’arrêt dans une boucle ou une récursivité, ou si vous avez de nombreux points d’arrêt que vous parcourez fréquemment, utilisez un point d’arrêt conditionnel.

Cette approche permet de s’assurer que votre code est suspendu uniquement lorsque des conditions spécifiques sont remplies. Un point d’arrêt conditionnel peut gagner du temps et faciliter le débogage des problèmes difficiles à reproduire.

Parcourir votre code

Visual Studio fournit plusieurs façons différentes d’indiquer au débogueur de poursuivre l’exécution de l’application. L’exemple suivant montre une commande utile pour parcourir votre code.

Pendant que le code est suspendu au point d’arrêt, pointez sur l’instruction return c2; jusqu’à ce que vous voyiez l’icône Exécuter verte pour cliquer (Exécuter l’exécution ici). Sélectionnez l’icône.

Capture d’écran montrant comment utiliser l’action Exécuter jusqu’au clic dans le débogueur de Visual Studio.

Capture d’écran montrant comment utiliser l’action Exécuter jusqu’au clic dans le débogueur de Visual Studio 2022.

L’application continue l’exécution et s’interrompt sur la ligne de code où vous avez cliqué sur le bouton.

Les commandes clavier courantes utilisées pour parcourir le code incluent F10 et F11. Pour obtenir des instructions plus détaillées, consultez Première vue sur le débogueur.

Inspecter les variables dans une infobulle

Vous pouvez inspecter l’état de vos variables à l’aide de la fonctionnalité de conseil de données .

  1. Dans la ligne de code actuelle (marquée par le pointeur d’exécution jaune), pointez sur l’objet c2 pour voir l’info-bulle de données.

    Capture d’écran montrant comment afficher les info-bulles de données pour les variables de code dans le débogueur Visual Studio.

    Capture d’écran montrant comment afficher les info-bulles de données pour les variables du code dans le débogueur de Visual Studio 2022.

    L'info-bulle vous montre la valeur actuelle de la variable c2 et vous permet d'inspecter ses propriétés.

    Lorsque vous déboguez, si vous voyez une valeur inattendue pour une variable, vous avez probablement un bogue. Le bogue peut se trouver dans le code qui effectue l’appel à la variable ou dans la ligne précédente.

  2. Développez l'info-bulle pour examiner les valeurs de propriété actuelles de l'objet c2.

  3. Pour continuer à surveiller la valeur de c2 pendant l’exécution du code, sélectionnez l’icône en forme d’épingle sur l’info-bulle.

    L’action Épingler maintient l’infobulle de données ouverte. Lorsque le code s’exécute, la valeur de l’infobulle épinglée change pour afficher l’état actuel de l’objet surveillé.

    Vous pouvez déplacer l’info-bulle épinglée vers n’importe quel emplacement de l’IDE. Il n’empêche donc pas d’observer d’autres éléments lors du débogage.

Étape suivante

Vue d’ensemble du débogueur Visual Studio

  • Last updated on