Utiliser les points d’arrêt dans le débogueur Visual Studio

Les points d’arrêt sont l’une des techniques de débogage les plus importantes de la boîte à outils du développeur. Vous définissez des points d’arrêt partout où vous souhaitez mettre en pause l’exécution du débogueur. Par exemple, vous pouvez voir l’état des variables de code ou examiner la pile des appels sur un certain point d’arrêt. Si vous essayez de résoudre un avertissement ou un problème quand vous utilisez des points d’arrêt, consultez Résoudre les problèmes des points d’arrêt dans le débogueur Visual Studio.

Définir des points d’arrêt dans le code source

Vous pouvez définir un point d’arrêt sur n’importe quelle ligne de code exécutable. Par exemple, dans le code C# suivant, vous pouvez définir un point d’arrêt sur la ligne de code avec l’attribution de variable (int testInt = 1), la boucle for ou tout le code à l’intérieur de la boucle for. Vous ne pouvez pas définir de point d’arrêt sur les signatures de méthode, les déclarations d’un espace de noms ou d’une classe, ou les déclarations de variable s’il n’y a pas d’attribution ni de méthode getter/setter.

Pour définir un point d’arrêt dans le code source :

• Cliquez dans la marge complètement à gauche à côté d’une ligne de code. Vous pouvez également sélectionner la ligne et appuyer sur F9, sélectionner Déboguer>Activer/désactiver le point d’arrêt, ou faire un clic droit et sélectionner Point d’arrêt>Insérer un point d’arrêt. Le point d’arrêt s’affiche sous la forme d’un point rouge dans la marge à gauche.

Pour la plupart des langages, notamment C#, le point d’arrêt et les lignes d’exécution actuelles sont automatiquement mis en surbrillance. Pour le code C++, vous pouvez activer la mise en surbrillance du point d’arrêt et des lignes actuelles en sélectionnant Outils (ou Déboguer) >Options>Débogage>Mettre en surbrillance la ligne source entière pour les points d’arrêt et l’instruction actuelle (C++ uniquement).

Quand vous déboguez, l’exécution se met en pause sur le point d’arrêt, avant l’exécution du code sur cette ligne. Le symbole de point d’arrêt montre une flèche jaune.

Quand le débogueur s’arrête sur le point d’arrêt, vous pouvez examiner l’état actuel de l’application, y compris les valeurs de variable et la pile des appels.

Voici quelques instructions générales pour l’utilisation des points d’arrêt.

• Le point d’arrêt est un bouton bascule. Vous pouvez cliquer dessus, appuyer sur F9 ou utiliser Déboguer>Activer/désactiver le point d’arrêt pour le supprimer ou le réinsérer.

• Pour désactiver un point d’arrêt sans le supprimer, pointez dessus ou cliquez dessus avec le bouton droit, puis sélectionnez Désactiver le point d’arrêt. Les points d’arrêt désactivés s’affichent sous la forme de points vides dans la marge de gauche ou la fenêtre Points d’arrêt. Pour réactiver un point d’arrêt, pointez dessus ou cliquez dessus avec le bouton droit, puis sélectionnez Activer le point d’arrêt.

• Définissez des conditions et des actions, ajoutez et modifiez des étiquettes, ou exportez un point d’arrêt en cliquant dessus avec le bouton droit et en sélectionnant la commande appropriée, ou en pointant dessus et en sélectionnant l’icône Paramètres.

Actions de points d’arrêt et points de trace

Un point de trace est un point d’arrêt qui affiche un message dans la fenêtre Sortie. Un point de trace peut agir comme une instruction de trace temporaire dans le langage de programmation et ne met pas en pause l’exécution du code. Vous créez un point de trace en définissant une action spéciale dans la fenêtre Paramètres du point d’arrêt. Pour obtenir des instructions détaillées, consultez Utiliser des points de trace dans le débogueur Visual Studio.

Conditions de point d’arrêt

Vous pouvez contrôler quand et où un point d’arrêt s’exécute en définissant des conditions. La condition peut être n’importe quelle expression valide reconnue par le débogueur. Pour plus d’informations sur les expressions valides, consultez Expressions dans le débogueur.

Pour définir une condition de point d’arrêt :

1. Cliquez avec le bouton droit sur le symbole de point d’arrêt et sélectionnez Conditions (ou appuyez sur Alt + F9, C). Ou pointez sur le symbole de point d’arrêt, sélectionnez l’icône Paramètres, puis sélectionnez Conditions dans la fenêtre Paramètres du point d’arrêt.

   Vous pouvez également cliquer avec le bouton droit dans la marge complètement à gauche à côté d’une ligne de code et sélectionner Insérer un point d’arrêt conditionnel dans le menu contextuel pour définir un nouveau point d’arrêt conditionnel.

   Vous pouvez également définir des conditions dans la fenêtre Points d’arrêt en cliquant avec le bouton droit sur un point d’arrêt, en sélectionnant Paramètres, puis en sélectionnant Conditions

   

   

2. Dans la liste déroulante, sélectionnez Expression conditionnelle, Nombre d’accès ou Filtre, puis définissez la valeur en conséquence.

3. Sélectionnez Fermer ou appuyez sur Ctrl+Entrée pour fermer la fenêtre Paramètres du point d’arrêt. Sinon, dans la fenêtre Points d’arrêt, sélectionnez OK pour fermer la boîte de dialogue.

Les points d’arrêt avec des conditions définies s’affichent avec un symbole + dans le code source et les fenêtres Points d’arrêt.

Créer une expression conditionnelle

Quand vous sélectionnez Expression conditionnelle, vous avez le choix entre deux conditions : Est true et En cas de modification. Choisissez Est true pour arrêter l’exécution quand l’expression est satisfaite ou En cas de modification pour l’arrêter quand la valeur de l’expression a changé.

Dans l’exemple suivant, le point d’arrêt est atteint uniquement quand la valeur de testInt est 4 :

Dans l’exemple suivant, le point d’arrêt est atteint uniquement quand la valeur de testInt change :

Si vous définissez une condition de point d’arrêt dont la syntaxe est incorrecte, un message d’avertissement s’affiche. Si vous spécifiez une condition de point d’arrêt avec une syntaxe valide, mais dont la sémantique n’est pas valide, un message d’avertissement apparaît quand le point d’arrêt est atteint pour la première fois. Dans les deux cas, le débogueur s’arrête quand il atteint le point d’arrêt non valide. Le point d’arrêt n’est ignoré que si la condition est valide et prend la valeur false.

Utiliser des ID d’objet dans les expressions conditionnelles (C# et F# uniquement)

Parfois, vous voulez observer le comportement d’un objet spécifique. Par exemple, vous voulez savoir pourquoi un objet a été inséré plusieurs fois dans une collection. En C# et en F#, vous pouvez créer des ID d’objet pour des instances spécifiques de types référence et les utiliser dans des conditions de point d’arrêt. L’ID d’objet est généré par les services de débogage du Common Language Runtime (CLR) et associé à l’objet.

Pour créer un ID d’objet :

1. Définissez un point d’arrêt dans le code un peu après l’endroit où l’objet a été créé.

2. Démarrez le débogage et, quand l’exécution se met en pause sur le point d’arrêt, sélectionnez Déboguer>Fenêtres>Variables locales (ou appuyez sur Ctrl + Alt + V, L) pour ouvrir la fenêtre Variables locales.

   Recherchez l’instance d’objet spécifique dans la fenêtre Variables locales, cliquez dessus avec le bouton droit, puis sélectionnez Définir l’ID d’objet.

   Le symbole $ et un nombre s’affichent alors dans la fenêtre Variables locales . Il s’agit de l’ID d’objet.

3. Ajoutez un nouveau point d’arrêt conditionnel sur le point vous voulez investiguer, par exemple, quand l’objet est ajouté à la collection. Cliquez avec le bouton droit sur le point d’arrêt et sélectionnez Conditions.

4. Utilisez l’ID d’objet dans le champ Expression conditionnelle. Par exemple, si la variable item est l’objet à ajouter à la collection, sélectionnez Est true et tapez item == $<n>, où <n> est le numéro de l’ID d’objet.

   L’exécution s’arrête au point où cet objet doit être ajouté à la collection.

   Pour supprimer l’ID d’objet, cliquez avec le bouton droit sur la variable dans la fenêtre Variables locales, puis sélectionnez Supprimer l’ID d’objet.

Définir une condition de nombre d’accès

Si vous pensez qu’une boucle de votre code commence à avoir un comportement anormal après un certain nombre d’itérations, vous pouvez définir un point d’arrêt pour arrêter l’exécution au bout de ce nombre d’accès, plutôt que d’appuyer plusieurs fois sur F5 pour atteindre cette itération.

Sous Conditions dans la fenêtre Paramètres du point d’arrêt, sélectionnez Nombre d’accès, puis spécifiez le nombre d’itérations. Dans l’exemple suivant, le point d’arrêt est atteint à chaque itération :

Définir une condition de filtre

Vous pouvez limiter le déclenchement d’un point d’arrêt seulement sur des appareils spécifiés ou dans des processus et des threads spécifiés.

Sous Conditions dans la fenêtre Paramètres du point d’arrêt, sélectionnez Filtre, puis entrez une ou plusieurs des expressions suivantes :

• MachineName = "nom"
• ProcessId = valeur
• ProcessName = "nom"
• ThreadId = valeur
• ThreadName = "nom"

Placez les valeurs de chaîne entre guillemets doubles. Vous pouvez combiner des clauses à l’aide de & (AND), || (OR), ! (NOT) et de parenthèses.

Définir des points d’arrêt de fonction

Vous pouvez arrêter l’exécution quand une fonction est appelée. Cela est utile, par exemple, quand vous connaissez le nom de la fonction, mais pas son emplacement. C’est également utile si vous avez des fonctions du même nom et que vous souhaitez toutes les arrêter (comme des fonctions surchargées ou des fonctions dans différents projets).

Pour définir un point d’arrêt de fonction :

1. Sélectionnez Déboguer>Nouveau point d’arrêt>Point d’arrêt de fonction, ou appuyez sur Ctrl + K, B.

   Vous pouvez également sélectionner Nouveau>Point d’arrêt de fonction dans la fenêtre Points d’arrêt.

2. Dans la boîte de dialogue Nouveau point d’arrêt de fonction, entrez le nom de la fonction dans la zone Nom de la fonction.

   Pour affiner la spécification de la fonction :

   • Utilisez le nom complet de la fonction.

     Exemple : Namespace1.ClassX.MethodA()

   • Ajoutez les types de paramètre d’une fonction surchargée.

     Exemple : MethodA(int, string)

   • Utilisez le symbole « ! » pour spécifier le module.

     Exemple : App1.dll!MethodA

   • Utilisez l’opérateur de contexte en C++ natif.

     {function, , [module]} [+<line offset from start of method>]

     Exemple : {MethodA, , App1.dll}+2

3. Dans la liste déroulante Langage, choisissez le langage de la fonction.

4. Sélectionnez OK.

Définir un point d’arrêt de fonction en utilisant une adresse mémoire (C++ natif uniquement)

Vous pouvez aussi utiliser l’adresse d’un objet pour définir un point d’arrêt de fonction sur une méthode appelée par une instance spécifique d’une classe. Par exemple, avec un objet adressable de type my_class, vous pouvez définir un point d’arrêt de fonction sur la méthode my_method appelée par cette instance.

1. Définissez un point d’arrêt quelque part après l’instanciation de l’instance de la classe.

2. Recherchez l’adresse de l’instance (par exemple, 0xcccccccc).

3. Sélectionnez Déboguer>Nouveau point d’arrêt>Point d’arrêt de fonction, ou appuyez sur Ctrl + K, B.

4. Ajoutez ce qui suit à la zone Nom de la fonction, puis sélectionnez le langage C++.

   ((my_class *) 0xcccccccc)->my_method
   

Définir des points d’arrêt de données (C++ natif uniquement)

Les points d’arrêt de données arrêtent l’exécution quand une valeur stockée sur une adresse mémoire spécifiée change. Si la valeur est lue mais pas modifiée, l’exécution ne s’interrompt pas.

Pour définir un point d’arrêt de données :

1. Dans un projet C++, démarrez le débogage et attendez qu’un point d’arrêt soit atteint. Dans le menu Déboguer, choisissez Nouveau point d’arrêt>Nouveau point d’arrêt.

   Vous pouvez également sélectionner Nouveau>Point d’arrêt de données dans la fenêtre Points d’arrêt, ou cliquer avec le bouton droit sur un élément dans la fenêtre Automatique, Espion ou Variables locales, puis sélectionner Arrêter quand la valeur change dans le menu contextuel.

2. Dans la zone Adresse, tapez une adresse mémoire ou une expression qui prend comme valeur une adresse mémoire. Par exemple, tapez &avar pour interrompre l’exécution quand le contenu de la variable avar change.

3. Dans la zone déroulante Nombre d’octets , sélectionnez le nombre d’octets que le débogueur doit surveiller. Par exemple, si vous sélectionnez 4, le débogueur surveille les quatre octets à partir de &avar et interrompt l’exécution si l’un de ces octets change de valeur.

Les points d’arrêt de données ne fonctionnent pas dans les conditions suivantes :

• Un processus qui n’est pas en cours de débogage écrit à l’emplacement mémoire.
• L’emplacement mémoire est partagé entre plusieurs processus.
• L’emplacement de mémoire est mis à jour dans le noyau. Par exemple, si la mémoire est passée à la fonction ReadFile Windows 32 bits, elle est mise à jour à partir du mode noyau et le débogueur ne s’arrête pas sur la mise à jour.
• Quand l’expression watch est supérieure à 4 octets sur du matériel 32 bits et à 8 octets sur du matériel 64 bits. Il s’agit d’une limitation de l’architecture x86.

Limites matérielles du point d’arrêt des données

Le noyau Windows et le matériel sous-jacent ont les limites suivantes lors de la définition de points d’arrêt des données. La limite fait référence au nombre maximal de points d’arrêt des données que vous pouvez définir.

Gérer les points d'arrêt dans la fenêtre Points d'arrêt

Vous pouvez utiliser la fenêtre Points d’arrêt pour voir et gérer tous les points d’arrêt dans votre solution. Cet emplacement centralisé est particulièrement utile dans les grandes solutions ou dans les scénarios de débogage complexes où les points d’arrêt sont critiques.

Dans la fenêtre Points d’arrêt, vous pouvez rechercher, trier, filtrer, activer/désactiver ou supprimer des points d’arrêt. Vous pouvez également définir des conditions et des actions, ou ajouter un nouveau point d’arrêt de fonction ou de données.

Pour ouvrir la fenêtre Points d’arrêt, sélectionnez Déboguer>Fenêtres>Points d’arrêt, ou appuyez sur Ctrl+Alt+B.

Pour sélectionner les colonnes à afficher dans la fenêtre Points d’arrêt, sélectionnez Afficher les colonnes. Sélectionnez l’en-tête d’une colonne pour trier les points d’arrêt en fonction de cette colonne.

Étiquettes de point d’arrêt

Vous pouvez utiliser des étiquettes pour trier et filtrer la liste des points d’arrêt dans la fenêtre Points d’arrêt.

1. Pour ajouter une étiquette à un point d’arrêt, cliquez avec le bouton droit sur le point d’arrêt dans le code source ou la fenêtre Points d’arrêt, puis sélectionnez Modifier les étiquettes. Ajoutez une nouvelle étiquette ou choisissez une étiquette existante, puis sélectionnez OK.
2. Triez la liste des points d’arrêt dans la fenêtre Points d’arrêt en sélectionnant les en-têtes Étiquettes, Conditions ou d’autres en-têtes de colonne. Vous pouvez sélectionner les colonnes à afficher en sélectionnant Afficher les colonnes dans la barre d’outils.

Exporter et importer les points d'arrêt

Pour enregistrer ou partager l’état et l’emplacement de vos points d’arrêt, vous pouvez les exporter ou les importer.

• Pour exporter un seul point d’arrêt vers un fichier XML, cliquez avec le bouton droit sur le point d’arrêt dans le code source ou la fenêtre Points d’arrêt, puis sélectionnez Exporter ou Exporter sélectionné. Sélectionnez un emplacement d’exportation, puis sélectionnez Enregistrer. L’emplacement par défaut est le dossier de solution.
• Pour exporter plusieurs points d’arrêt, dans la fenêtre Points d’arrêt, cochez les case à côté des points d’arrêt ou entrez des critères de recherche dans le champ Rechercher. Sélectionnez l’icône Exporter tous les points d’arrêt correspondant aux critères de recherche actuels, puis enregistrez le fichier.
• Pour exporter tous les points d’arrêt, décochez toutes les cases et laissez le champ Rechercher vide. Sélectionnez l’icône Exporter tous les points d’arrêt correspondant aux critères de recherche actuels, puis enregistrez le fichier.
• Pour importer des points d’arrêt, dans la fenêtre Points d’arrêt, sélectionnez l’icône Importer des points d’arrêt à partir d’un fichier, accédez à l’emplacement du fichier XML, puis sélectionnez Ouvrir.

Définir des points d’arrêt à partir des fenêtres du débogueur

Vous pouvez également définir des points d’arrêt à partir des fenêtres de débogueur Pile des appels et Désassemblage.

Définir un point d’arrêt dans la fenêtre Pile des appels

Pour arrêter l’exécution sur l’instruction ou la ligne à laquelle une fonction appelante renvoie, vous pouvez définir un point d’arrêt dans la fenêtre Pile des appels.

Pour définir un point d’arrêt dans la fenêtre Pile des appels :

1. Pour ouvrir la fenêtre Pile des appels, vous devez être en pause pendant le débogage. Sélectionnez Déboguer>Fenêtres>Pile des appels, ou appuyez sur Ctrl+Alt+C.

2. Dans la fenêtre Pile des appels, cliquez avec le bouton droit sur la fonction appelante et sélectionnez Point d’arrêt>Insérer un point d’arrêt, ou appuyez sur F9.

   Un symbole de point d’arrêt s’affiche à côté du nom de l’appel de fonction, dans la marge de gauche de la pile des appels.

Le point d’arrêt de pile des appels s’affiche dans la fenêtre Points d’arrêt sous la forme d’une adresse, avec un emplacement de mémoire correspondant à la prochaine instruction exécutable de la fonction.

Le débogueur s’arrête sur l’instruction.

Pour plus d’informations sur la pile des appels, consultez Comment : utiliser la fenêtre Pile des appels.

Pour suivre visuellement les points d’arrêt pendant l’exécution du code, consultez Mapper des méthodes sur la pile des appels pendant le débogage.

Définir un point d’arrêt dans la fenêtre Désassemblage

1. Pour ouvrir la fenêtre Désassemblage, vous devez être en pause pendant le débogage. Sélectionnez Déboguer>Fenêtres>Désassemblage, ou appuyez sur Ctrl+Alt+D.

2. Dans la fenêtre Désassemblage, cliquez dans la marge gauche de l’instruction sur laquelle vous souhaitez vous arrêter. Vous pouvez également la sélectionner et appuyer sur F9, ou cliquer avec le bouton droit et sélectionner Point d’arrêt>Insérer un point d’arrêt.

Contenu connexe

• Qu’est-ce que le débogage ?
• Écrire un meilleur code C# avec Visual Studio
• Aperçu du débogage
• Résoudre les problèmes de points d’arrêt dans le débogueur Visual Studio