Démarrer, Pas à pas principal, Exécuter du code et Arrêter le débogage dans Visual Studio

Commencer à déboguer un projet VS ; attacher à un processus ; s'arrêter dans le code ; parcourir le code ; effectuer une exécution jusqu'au curseur, effectuer une exécution jusqu'à une fonction de la pile des appels ; définir l'instruction suivante ; parcourir Uniquement mon code ; arrêter ; redémarrer le débogage ; détacher d'un processus débogué.

Sommaire

Start debugging a VS project; attach to a process

Break into code, step or run through code, set the next statement to execute

Stop, restart debugging; detach from the debugged process

Commencer à déboguer un projet VS ; attacher à un processus

• Start debugging a VS project**|**Attach to a process

Commencer à déboguer un projet VS

Lorsqu'une solution est ouverte dans Visual Studio, vous avez trois options pour démarrer le débogage :

Sélectionnez Déboguer, Démarrer le débogage (raccourci : F5).	Votre application démarre et s'exécute jusqu'à ce que : le débogueur rencontre un point d'arrêt ; vous choisissiez Arrêter le débogage, dans le menu Déboguer ; une exception soit levée ; l'application se ferme.
Choisissez Déboguer, Pas à pas détaillé (raccourci : F11) ou Déboguer, Pas à pas principal (raccourci : F10).	Votre application démarre puis s'arrête à la première ligne.
Dans une fenêtre source, sélectionnez une ligne de code exécutable et choisissez Exécuter jusqu'au curseur dans le menu contextuel.	Votre application démarre et s'exécute jusqu'au premier point d'arrêt ou jusqu'au curseur, selon le premier des deux qu'elle rencontre.

Pour suivre visuellement l'exécution de votre code sur une carte du code pendant le débogage, consultez Mapper les méthodes sur la pile des appels tout en déboguant dans Visual Studio.

Contents | Start debugging a VS project; attach to a process

Attacher à un processus

Le débogueur peut également attacher un programme qui s'exécute dans un processus en dehors de Visual Studio. Une fois l'attachement au programme effectué, vous pouvez utiliser les commandes d'exécution du débogueur, inspecter l'état du programme, et ainsi de suite. Les possibilités d'inspection peuvent dépendre de la présence d'informations de débogage dans le programme, de vos droits d'accès au code source de ce dernier et du suivi des informations de débogage par le compilateur JIT Common Language Runtime.

Pour effectuer un attachement à un processus qui s'exécute sur votre ordinateur local

Sélectionnez Déboguer, Attacher au processus. Dans la boîte de dialogue Attacher au processus, sélectionnez le processus dans la liste Processus disponibles, puis choisissez Attacher.

Pour plus d'informations, consultez Attacher aux processus en cours d'exécution avec le débogueur Visual Studio.

Contents | Start debugging a VS project; attach to a process

S'arrêter dans le code, parcourir le code, définir l'instruction suivante à exécuter

• Break into code by using breakpoints or Break All**|Step into, over, or out of the code|Run to a specified location or function|Set the next statement to execute|Restrict stepping to Just My Code|Step into system calls|**Step into properties and operators in managed code

S'arrêter dans le code en utilisant des points d'arrêt ou Interrompre tout

Lorsque vous déboguez une application avec le débogueur VS, elle est soit en cours d'exécution, soit en mode arrêt.

Le débogueur interrompt l'exécution de l'application lorsqu'il rencontre un point d'arrêt ou lorsqu'une exception se produit. Vous pouvez également interrompre manuellement l'exécution à tout moment.

Un point d'arrêt est un signal qui indique au débogueur de suspendre temporairement l'exécution de votre application à un certain point. Lorsque l'exécution est suspendue au niveau d'un point d'arrêt, votre programme est dit en mode arrêt. Le passage en mode arrêt ne termine pas l'exécution de votre programme, qui peut reprendre à tout moment.

La plupart des fonctionnalités du débogueur, comme l'affichage des valeurs des variables dans la fenêtre Variables locales ou l'évaluation des expressions dans la fenêtre Espion, sont disponibles uniquement en mode arrêt. Tous les éléments de votre application (fonctions, variables et objets, par exemple) restent en mémoire, mais leurs mouvements et leurs activités sont suspendus. En mode arrêt, vous pouvez examiner leurs positions et états à la recherche de violations ou de bogues. Vous pouvez également apporter des réglages à l'application en mode arrêt.

Vous pouvez configurer des points d'arrêt pour interrompre l'exécution selon plusieurs conditions. Consultez Points d'arrêt : utiliser les nombres d'accès, les fonctions de la pile des appels et les conditions d'arrêt quand et où vous le voulez dans le débogueur Visual Studio. Cette section décrit deux méthodes de base pour arrêter le code.

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

Pour définir un point d'arrêt simple dans votre code, ouvrez le fichier source dans l'éditeur Visual Studio. Définissez le curseur sur la ligne de code à laquelle vous souhaitez vous arrêter, puis choisissez Point d'arrêt, Insérer un point d'arrêt dans le menu contextuel (raccourci : F9. Le débogueur interrompt l'exécution juste avant que la ligne soit exécutée.

Les points d'arrêt dans Visual Studio fournissent un ensemble enrichi de fonctionnalités supplémentaires, telles que les points d'arrêt et les points de trace conditionnels. Consultez Points d'arrêt : utiliser les nombres d'accès, les fonctions de la pile des appels et les conditions d'arrêt quand et où vous le voulez dans le débogueur Visual Studio.

S'arrêter manuellement dans le code

Pour vous arrêter sur la ligne de code suivante disponible dans une application en cours d'exécution, choisissez Déboguer, Interrompre tout (raccourci : Ctrl+Alt+Break).

• Si vous déboguez avec l'option Uniquement mon code activée, l'exécution s'interrompt à la ligne de code suivante dans votre projet. Consultez Restrict stepping to Just My Code.

• Si vous déboguez plusieurs programmes, un point d'arrêt ou une commande Interrompre tout affecte par défaut tous les programmes en cours de débogage. Consultez Configure the execution behavior of multiple processes.

• Si vous interrompez l'exécution de code sans fichiers sources ou de symboles (.pdf) correspondants, le débogueur affiche une page Fichiers sources introuvables ou Symboles introuvables qui peut vous aider à trouver les fichiers appropriés. Consultez Spécifiez les fichiers de symbole (.pdb) et les fichiers source dans le débogueur Visual Studio..

  Si vous ne pouvez pas accéder aux fichiers de prise en charge, vous pouvez tout de même déboguer les instructions assembleur dans la fenêtre Code Machine.

Contents | Break into code, step or run through code, set the next statement to execute

Effectuer un pas à pas détaillé, principal ou sortant

L'une des procédures de débogage les plus communes est l'exécution pas à pas. L'exécution pas à pas consiste à exécuter le code ligne par ligne. Lorsque vous avez interrompu l'exécution, par exemple en exécutant le débogueur à un point d'arrêt, vous pouvez utiliser trois commandes du menu Déboguer pour parcourir votre code :

Commande de menu	Raccourci clavier	Description
Pas à pas détaillé	F11	Si la ligne contient un appel à une fonction, Pas à pas détaillé n'exécute que l'appel, puis s'arrête à la première ligne de code se trouvant dans la fonction. Sinon, Pas à pas détaillé exécute l'instruction suivante.
Pas à pas principal	F10	Si la ligne contient un appel à une fonction, Pas à pas principal exécute la fonction appelée, puis s'arrête à la première ligne de code se trouvant dans la fonction appelante. Sinon, Pas à pas détaillé exécute l'instruction suivante.
Pas à pas sortant	Shift+F11	Pas à pas sortant reprend l'exécution de votre code jusqu'au retour de la fonction, puis opère une interruption au point de retour dans la fonction appelante.

• Dans un appel à plusieurs fonctions imbriquées, Pas à pas détaillé va jusqu'à la fonction se trouvant au niveau le plus profond. Si vous utilisez Pas à pas détaillé dans un appel tel que Func1(Func2()), le débogueur parcourt la fonction Func2.

• En fait, le débogueur parcourt les instructions de code plutôt que les lignes physiques. Par exemple, une clause if peut être écrite sur une ligne :

  int x = 42;
  string s = "Not answered";
  if( int x == 42) s = "Answered!";
  

  Dim x As Integet = 42
  Dim s As String = "Not answered"
  If x = 42 Then s = "Answered!"
  

  Lorsque vous parcourez cette ligne, le débogueur traite la condition comme une étape et la conséquence comme une autre (dans cet exemple, la condition est remplie).

Pour suivre visuellement la pile des appels tout en effectuant un pas à pas détaillé dans les fonctions, consultez Mapper les méthodes sur la pile des appels tout en déboguant dans Visual Studio.

Contents | Break into code, step or run through code, set the next statement to execute

Exécuter à un emplacement ou une fonction spécifié(e)

Parfois, il est nécessaire d'exécuter le code jusqu'à un certain point, puis d'interrompre l'exécution. Si un point d'arrêt est défini à l'emplacement où vous souhaitez interrompre l'exécution, choisissez Déboguer, Démarrer le débogage si vous n'avez pas démarré le débogage, ou Déboguer, Continuer. (Dans les deux cas, le raccourci est F5.) Le débogueur s'arrête au point d'arrêt suivant dans l'exécution du code. Sélectionnez Déboguer, Continuer jusqu'à atteindre le point d'arrêt souhaité.

Vous pouvez également exécuter le code jusqu'à l'emplacement du curseur dans l'éditeur de code ou jusqu'à la fonction spécifiée.

Exécuter le code jusqu'à l'emplacement du curseur

Pour exécuter le code jusqu'à l'emplacement du curseur, placez le curseur sur une ligne de code exécutable dans une fenêtre source. Dans le menu contextuel de l'éditeur, choisissez Exécuter jusqu'au curseur.

Exécuter le code jusqu'à une fonction de la pile des appels

Dans la fenêtre Pile des appels, sélectionnez la fonction, puis choisissez Exécuter jusqu'au curseur dans le menu contextuel. Pour suivre visuellement la pile des appels, consultez Mapper les méthodes sur la pile des appels tout en déboguant dans Visual Studio.

Exécuter le code jusqu'à une fonction spécifiée par nom

Vous pouvez demander au débogueur d'exécuter une application jusqu'à une fonction spécifiée. Vous pouvez spécifier la fonction par nom ou la sélectionner dans la pile des appels.

Pour spécifier une fonction par nom, choisissez Déboguer, Nouveau point d'arrêt, Interrompre à la fonction, puis tapez le nom de la fonction et d'autres informations d'identification.

Si la fonction est surchargée ou si elle figure dans plusieurs espaces de noms, vous pouvez choisir les fonctions souhaitées dans la boîte de dialogue Choisir les points d'arrêt.

Contents | Break into code, step or run through code, set the next statement to execute

Définir l'instruction suivante à exécuter

Après une interruption dans le débogueur, vous pouvez déplacer le point d'exécution pour désigner l'instruction suivante à exécuter. Dans la marge d'une fenêtre source ou Code Machine, une flèche jaune marque l'emplacement de la prochaine instruction à exécuter. Déplacer cette flèche permet d'ignorer une partie du code ou de revenir à une ligne déjà exécutée. Vous pouvez utiliser cette fonctionnalité, par exemple, pour ignorer une section de code qui contient un bogue connu.

Pour définir l'instruction suivante à exécuter, appliquez l'une de ces procédures :

• Dans une fenêtre source, faites glisser la flèche jaune vers l'emplacement où vous souhaitez définir l'instruction suivante dans le même fichier source.

• Dans une fenêtre source, définissez le curseur sur la ligne que vous souhaitez exécuter ensuite et choisissez Définir l'instruction suivante dans le menu contextuel.

• Dans la fenêtre Code Machine, définissez le curseur sur l'instruction assembleur que vous souhaitez exécuter ensuite et choisissez Définir l'instruction suivante dans le menu contextuel.

Avertissement

Le fait de définir l'instruction suivante fait en sorte que le compteur du programme accède directement au nouvel emplacement.Utilisez cette commande avec précaution :

• Les instructions entre les nouveaux et les anciens points d'exécution ne sont pas exécutées.

• Si vous déplacez le point d'exécution vers l'arrière, les instructions déjà traitées ne sont pas annulées.

• Le déplacement de l'instruction suivante vers une autre fonction ou portée entraîne généralement une altération de la pile des appels, provoquant une erreur ou exception d'exécution.Si vous tentez de déplacer l'instruction suivante vers une autre portée, le débogueur ouvre une boîte de dialogue avec un avertissement et vous donne une occasion d'annuler l'opération.En Visual Basic, vous ne pouvez pas déplacer l'instruction suivante à une autre portée ou fonction.

• En C++ natif, si les contrôles d'exécution sont activés, la définition de l'instruction suivante peut provoquer la levée d'une exception lorsque l'exécution atteint la fin de la méthode.

• Lorsque Modifier & Continuer est activé, la commande Définir l'instruction suivante échoue si vous avez apporté des modifications qui ne peuvent pas être remappées immédiatement par Modifier & Continuer.Par exemple, cela peut se produire si vous avez modifié le code contenu dans un bloc catch.Lorsque cela se produit.Un message d'erreur s'affiche pour indiquer que l'opération n'est pas prise en charge.

Notes

Dans du code managé, vous ne pouvez pas déplacer l'instruction suivante dans les conditions suivantes :

• L'instruction suivante se trouve dans une méthode différente de celle de l'instruction actuelle.

• Le débogage a été démarré à l'aide du débogage juste-à-temps.

• Le déroulement d'une pile des appels est en cours.

• Une exception System.StackOverflowException ou System.Threading.ThreadAbortException a été levée.

Il est impossible de définir l'instruction suivante lorsque l'application est active. Pour définir l'instruction suivante, le débogueur doit être en mode arrêt.

Contents | Break into code, step or run through code, set the next statement to execute

Limiter le pas à pas à Uniquement mon code

Parfois, en cours de débogage, vous pouvez être amené à examiner uniquement le code que vous avez écrit et ignorer les autres éléments de code, par exemple les appels système. C'est précisément ce que permet de faire le mode de débogage Uniquement mon code. Uniquement mon code masque le code non-utilisateur pour l'empêcher d'apparaître dans les fenêtres du débogueur. Lorsque vous parcourez le code, le débogueur parcourt le code de non-utilisateur sans s'y arrêter. Consultez Uniquement mon code.

Notes

Uniquement mon code n'est pas pris en charge pour les projets Smart Device.

Contents | Break into code, step or run through code, set the next statement to execute

Effectuer un pas à pas détaillé dans des appels système

Si vous avez chargé des symboles de débogage pour le code système et que l'option Uniquement mon code n'est pas activée, vous pouvez effectuer un pas à pas détaillé dans un appel système tout comme s'il s'agissait de n'importe quel autre appel.

Pour savoir comment désactiver Uniquement mon code, voir Restrict stepping to Just My Code

Pour accéder aux fichiers de symboles Microsoft, voir Use symbol servers to find symbol files not on your local machine dans la rubrique Spécifiez les fichiers de symbole (.pdb) et les fichiers source dans le débogueur Visual Studio..

Pour charger des symboles pour un composant système spécifique lors du débogage :

1. Ouvrez la fenêtre Modules (raccourci : Ctrl+Alt+U).

2. Sélectionnez le module pour lequel vous souhaitez charger des symboles.

   Consultez la colonne État du symbole pour connaître les modules qui possèdent des symboles chargés.

3. Choisissez Charger les symboles dans le menu contextuel.

Contents | Break into code, step or run through code, set the next statement to execute

Effectuer un pas à pas détaillé dans des propriétés et des opérateurs au sein du code managé

Par défaut, le débogueur effectue un pas à pas principal sur les propriétés et les opérateurs dans le code managé. Dans la plupart des cas, cela fournit une meilleure expérience de débogage. Pour activer le pas à pas détaillé des propriétés ou des opérateurs, choisissez Déboguer, Options et paramètres. Dans la page Débogage, Général, désactivez la case à cocher Pas à pas principal dans les propriétés et les opérateurs (Managé uniquement).

Contents | Break into code, step or run through code, set the next statement to execute

Arrêter, redémarrer le débogage ; détacher du processus débogué

Arrêter le débogage signifie mettre fin à la session de débogage. Arrêter l'exécution signifie arrêter le processus en cours de débogage et mettre fin à la session de débogage. Ne confondez pas l'arrêt et l'interruption de l'exécution, laquelle suspend temporairement l'exécution du processus en cours de débogage sans désactiver la session de débogage. Le détachement d'un processus interrompt le débogage du processus mais pas son exécution.

• Stop debugging from VS**|Close the app that is being debugged|Restart debugging|**Detach from the debugged app

Arrêter le débogage à partir de VS

Sélectionnez Déboguer, Arrêter le débogage pour mettre fin au processus que vous déboguez lorsque le programme a été lancé à partir de Visual Studio. Si vous avez attaché le processus au lieu de le lancer à partir de Visual Studio, l'exécution du processus se poursuit.

Contents | Stop, restart debugging; detach from the debugged process

Fermer l'application en cours de débogage

Lorsque vous quittez une application en cours de débogage, celle-ci s'arrête automatiquement.

Redémarrer le débogage

Sélectionnez Déboguer, Redémarrer pour arrêter la session de débogage actuelle et redémarrer le projet de démarrage dans le débogueur.

Contents | Stop, restart debugging; detach from the debugged process

Détacher de l'application déboguée

Sélectionnez Déboguer, Détacher tout pour arrêter le débogage mais poursuivre l'exécution des processus débogués.

Conseil

Pour en savoir plus sur l'attachement et le contrôle de plusieurs processus avec Visual Studio, consultez Attacher aux processus en cours d'exécution avec le débogueur Visual Studio et Déboguer un ou plusieurs processus dans Visual Studio.

Contents | Stop, restart debugging; detach from the debugged process