Options générales de débogage

Pour définir les options du débogueur Visual Studio, sélectionnez Options d’outils>, puis, sous Débogage, sélectionnez ou désélectionnez les cases en regard des options Générales. Vous pouvez restaurer tous les paramètres par défaut avec Tools>Paramètres d’importation et d’exportation>Réinitialiser tous les paramètres. Pour réinitialiser un sous-ensemble de paramètres, enregistrez vos paramètres avec l’Assistant Importation et Exportation des paramètres avant d’apporter les modifications que vous souhaitez tester, puis importez vos paramètres enregistrés par la suite.

Vous pouvez définir les options générales suivantes :

Demander avant de supprimer tous les points d’arrêt: nécessite une confirmation avant de terminer la commande Supprimer tous les points d’arrêt.

Interrompre tous les processus lorsqu’un processus se bloque: arrête simultanément tous les processus auxquels le débogueur est attaché, lorsqu’un arrêt se produit.

Interrompez lorsque des exceptions dépassent les limites AppDomain ou managées/natives : en mode managé ou en mode mixte, l'environnement d'exécution de langage commun peut intercepter les exceptions qui dépassent les limites AppDomain ou les limites managées/natives lorsque trois conditions sont remplies :

• Condition 1 : Lorsque le code natif appelle du code managé à l’aide de COM Interop et que le code managé lève une exception. Consultez Présentation de COM Interop.

• Condition 2 : Lorsque le code managé s’exécutant dans le domaine d’application 1 appelle du code managé dans le domaine d’application 2 et que le code du domaine d’application 2 lève une exception. Consultez Programmation avec des domaines d’application.

• Condition 3 : Lorsque le code appelle une fonction à l’aide de la réflexion et que cette fonction lève une exception. Consultez Réflexion.

• Pour les conditions 2 et 3, l’exception est parfois interceptée par du code managé dans mscorlib plutôt que par le Common Language Runtime. Cette option n’affecte pas la rupture des exceptions interceptées par mscorlib.

Activer le débogage au niveau de l’adresse: active les fonctionnalités avancées pour le débogage au niveau de l’adresse (la fenêtre Désassembler, la fenêtre Inscrire et les points d’arrêt d’adresse).

• Afficher le désassemblement si la source n’est pas disponible: affiche automatiquement la fenêtre Désassemblement lorsque vous déboguez du code pour lequel la source n’est pas disponible.

Activer les filtres de point d’arrêt : vous permet de définir des filtres sur des points d’arrêt afin qu’ils affectent uniquement des processus, des threads ou des ordinateurs spécifiques.

Utiliser le nouvel assistant d'exception: active le Helper d'exception qui remplace l'assistant d'exception. (L’assistance sur les exceptions est prise en charge à partir de Visual Studio 2017)

Remarque

Pour le code managé, cette option a été appelée précédemment Activer l’Assistant Exception.

Activez uniquement mon code : le débogueur affiche et décrit les étapes du code utilisateur (« Mon code ») uniquement, ignorant le code système et d’autres codes optimisés ou qui n’ont pas de symboles de débogage.

• Avertir si aucun code utilisateur n’est lancé (géré uniquement) : lorsque le débogage commence par Just My Code activé, cette option vous avertit s’il n’y a pas de code utilisateur (« Mon code »).

Activer l’exécution pas à pas du code source du .NET Framework : permet au débogueur d’effectuer un pas à pas détaillé dans la source .NET Framework. L’activation de cette option désactive automatiquement uniquement mon code. Les symboles .NET Framework sont téléchargés vers un emplacement de cache. Vous pouvez modifier l’emplacement du cache dans la section DébogageEmplacements de recherche des symboles avec l’option Cachez les symboles dans ce répertoire.

Déboguer automatiquement les fonctions déboguées lorsque cela est possible (.Net 8+, Débogage dynamique C++) : lorsque cette option est sélectionnée, désoptimise les fonctions déboguées pour une expérience de débogage plus complète.

Supprimer l’optimisation JIT sur le chargement de module (géré uniquement): désactive l’optimisation JIT du code managé lorsqu’un module est chargé et que JIT est compilé pendant que le débogueur est attaché. La désactivation de l’optimisation peut faciliter le débogage de certains problèmes, bien qu’au détriment des performances. Si vous utilisez Simplement mon code, la suppression de l’optimisation JIT peut entraîner l’affichage du code non-utilisateur en tant que code utilisateur (« Mon code »). Pour plus d’informations, consultez Optimisation et débogage JIT.

Configurez l’utilisation d’images précompilées (gérées uniquement) : lorsque vous sélectionnez ce lien, la boîte de dialogue Options du débogueur Visual Studio s’ouvre. Pour activer l’option, activez la case à cocher Empêcher l’utilisation d’images précompilées sur le chargement du module , puis sélectionnez OK. Lorsqu’il est sélectionné, désactive le chargement des images précompilées NGEN ou RDR.

Configurer le débogage juste-à-temps : lorsque vous sélectionnez ce lien, la boîte de dialogue Options du débogueur Visual Studio s’ouvre. Pour activer l’option, activez la case à cocher Activer le débogage juste-à-temps pour ces types de code . Sélectionnez un ou plusieurs types de code : Natif et Géré (.NET Framework), puis sélectionnez OK. Cette option active le débogage juste-à-temps pour les types de code sélectionnés.

Pas à pas principal dans les propriétés et les opérateurs (Managé uniquement) : empêche le débogueur d’effectuer un pas à pas détaillé dans les propriétés et les opérateurs dans le code managé.

Activer l’évaluation des propriétés et d’autres appels de fonction implicites: active l’évaluation automatique des propriétés et des appels de fonction implicites dans les fenêtres variables et la boîte de dialogue QuickWatch.

• Appeler la fonction de conversion de chaîne sur les objets dans les fenêtres de variables : exécute un appel de conversion de chaîne implicite lors de l’évaluation d’objets dans les fenêtres de variables. Le résultat est affiché sous forme de chaîne au lieu du nom de type. S’applique uniquement lors du débogage dans le code C#. Ce paramètre peut être remplacé par l’attribut DebuggerDisplay (voir Utilisation de l’attribut DebuggerDisplay).

Activer la prise en charge du serveur source: indique au débogueur Visual Studio d’obtenir des fichiers sources à partir de serveurs sources qui implémentent le protocole SrcSrv (srcsrv.dll). Team Foundation Server et les outils de débogage pour Windows sont deux serveurs sources qui implémentent le protocole. Pour plus d’informations sur la configuration de SrcSrv, consultez la documentation SrcSrv. En outre, consultez Spécifier les fichiers de symbole (.pdb) et les fichiers sources.

Important

Étant donné que lire des fichiers .pdb peut exécuter du code arbitraire, assurez-vous de faire confiance au serveur.

• Imprimer les messages de diagnostic du serveur source dans la fenêtre Sortie: lorsque la prise en charge du serveur source est activée, ce paramètre active l’affichage des diagnostics.

• Autoriser le serveur source pour les assemblys d’approbation partielle (gérés uniquement): lorsque la prise en charge du serveur source est activée, ce paramètre remplace le comportement par défaut de ne pas récupérer les sources pour les assemblys d’approbation partielle.

• Toujours exécuter des commandes de serveur source non approuvées sans inviter: lorsque la prise en charge du serveur source est activée, ce paramètre remplace le comportement par défaut de l’invite lors de l’exécution d’une commande non approuvée.

Activer la prise en charge du lien source : indique au débogueur Visual Studio de télécharger les fichiers sources pour les fichiers .pdb qui contiennent des informations de lien source. Pour plus d’informations sur le lien source, consultez la spécification du lien source .

Important

Étant donné que Source Link télécharge des fichiers en utilisant http ou https, assurez-vous de faire confiance au fichier .pdb.

• Revenir à l’authentification Git Credential Manager pour toutes les demandes de liaison source: lorsque la prise en charge du lien source est activée et qu’une demande de liaison source échoue, Visual Studio appelle ensuite Git Credential Manager.

Mettre en surbrillance toute la ligne source pour les points d’arrêt et l’instruction actuelle (C++ uniquement): lorsque le débogueur met en surbrillance un point d’arrêt ou une instruction actuelle, il met en surbrillance toute la ligne.

Exiger que les fichiers sources correspondent exactement à la version d’origine : indique au débogueur de vérifier qu’un fichier source correspond à la version du code source utilisé pour générer l’exécutable que vous déboguez. Lorsque la version ne correspond pas, vous êtes invité à trouver une source correspondante. Si aucune source correspondante n’est trouvée, le code source n’est pas affiché pendant le débogage.

Rediriger tout le texte de la fenêtre Sortie vers la fenêtre Exécution : envoie tous les messages du débogueur qui s’affichent normalement dans la fenêtre Sortie vers la fenêtre Exécution.

Afficher la structure brute des objets dans les fenêtres variables: désactive toutes les personnalisations d’affichage de structure d’objets. Pour plus d’informations sur les personnalisations d’affichage, consultez Créer des vues personnalisées d’objets managés.

Activer le débogage JavaScript pour ASP.NET (Chrome et Edge) : active le débogueur de script pour les applications ASP.NET. Lors de la première utilisation dans Chrome, vous devrez peut-être vous connecter au navigateur pour activer les extensions Chrome que vous avez installées. Désactivez cette option pour revenir au comportement hérité.

Charger les exportations de dll (Natif uniquement) : charge les tables d’exportation dll. Les informations sur les symboles des tables d’exportation dll peuvent être utiles si vous utilisez des messages Windows, des procédures Windows (WindowProcs), des objets COM, du marshaling ou toute dll pour laquelle vous n’avez pas de symboles. La lecture des informations d’exportation de DLL implique un surcoût. Par conséquent, cette fonctionnalité est désactivée par défaut.

• Pour voir quels symboles sont disponibles dans la table d’exportation d’une dll, utilisez dumpbin /exports. Les symboles sont disponibles pour tout DLL système 32 bits. En lisant la dumpbin /exports sortie, vous pouvez voir le nom exact de la fonction, y compris les caractères non nonphanumériques. Cela est utile pour définir un point d’arrêt sur une fonction. Les noms de fonction des tables d’exportation dll peuvent apparaître tronqués ailleurs dans le débogueur. Les appels sont répertoriés dans l’ordre d’appel, avec la fonction actuelle (la plus profondément imbriquée) en haut. Pour plus d’informations, consultez dumpbin /exports.

Ignorer les exceptions d’accès à la mémoire GPU si les données écrites n’ont pas modifié la valeur : ignore les conditions de concurrence détectées lors du débogage si les données n’ont pas changé. Pour plus d’informations, consultez Débogage du code GPU.

Avertir lorsque vous utilisez des visualiseurs de débogueur personnalisés contre des processus potentiellement dangereux (gérés uniquement) : Visual Studio vous avertit lorsque vous utilisez un visualiseur de débogueur personnalisé qui exécute du code dans le processus débogué, car il peut exécuter du code non sécurisé.

Activer le débogage de l’allocateur de tas Windows (Natif uniquement) : permet au tas de débogage Windows d’améliorer les diagnostics du tas. L’activation de cette option a un impact sur les performances de débogage.

Activer les outils de diagnostic lors du débogage : la fenêtre Outils de diagnostic s’affiche pendant le débogage.

Afficher le temps écoulé pendant le débogage : la fenêtre de code affiche le temps écoulé d’un appel de méthode donné lorsque vous déboguez.

Bouton Afficher l’exécution au clic lors du débogage : lorsque cette option est sélectionnée, le bouton Exécuter en un clic s’affiche lors du débogage.

fermer automatiquement la console lorsque le débogage s’arrête: indique à Visual Studio de fermer la console à la fin d’une session de débogage.

Activer l’évaluation rapide des expressions (gérée uniquement): permet au débogueur de tenter une évaluation plus rapide en simulant l’exécution de propriétés et de méthodes simples.

Charger des symboles de débogage dans un processus externe (natif uniquement) : active cette optimisation de la mémoire lors du débogage.

Apportez Visual Studio au premier plan lors d’une rupture dans le débogueur : bascule Visual Studio au premier plan lorsque vous effectuez une pause dans le débogueur.

Gardez les info-bulles de données développées ouvertes jusqu'à ce que vous cliquiez ailleurs : lorsque cette option est sélectionnée, une info-bulle de données développée reste déployée jusqu'à ce que vous cliquiez ailleurs.

Activez le nœud Sources externes dans l’Explorateur de solutions : lorsque vous l’avez sélectionné, affiche le code décompilé sous le nœud Sources externes.

Décompiler automatiquement vers la source au besoin (géré uniquement) : lorsqu'il est sélectionné, décompile automatiquement le code .NET externe lors de l'accès au code externe.

Mettre en surbrillance l’instruction en cours et les instructions avec des points d’arrêt : lorsque le débogueur met en évidence un point d’arrêt ou une instruction en cours, il met en surbrillance toute la ligne.

Afficher les valeurs de variables en ligne dans l’éditeur lors du débogage : Affichez les valeurs des variables dans l’instruction mise en surbrillance dans le débogueur.

• Afficher les valeurs de retour inline : affichez les valeurs de retour de l’instruction mise en surbrillance dans le débogueur.

• Afficher les valeurs d’argument de fonction en ligne : afficher les valeurs des arguments de fonction dans l’instruction mise en évidence dans le débogueur.

• Afficher les valeurs des expressions de la ligne actuelle en ligne : afficher les valeurs des expressions dans la ligne actuelle dans le débogueur.

Options disponibles dans les versions antérieures de Visual Studio

Si vous utilisez une version antérieure de Visual Studio, d’autres options peuvent être présentes.

Activer les outils de développement Edge pour les applications JavaScript UWP (expérimentales): active les outils de développement pour les applications JavaScript UWP dans Microsoft Edge.

Activer le débogueur JavaScript Chrome hérité pour ASP.NET: active le débogueur de script JavaScript Chrome hérité pour les applications ASP.NET. Lors de la première utilisation dans Chrome, vous devrez peut-être vous connecter au navigateur pour activer les extensions Chrome que vous avez installées.

Activer l’Assistant Exception: pour le code managé, active l’Assistant Exception. À compter de Visual Studio 2017, l'Assistant d'exception a remplacé l'auxiliaire d'exception.

Dérouler la pile des appels sur les exceptions non gérées : la fenêtre Pile des appels restaure la pile des appels au point qui précède l’exception non gérée.

Utiliser une méthode expérimentale pour lancer le débogage JavaScript Chrome lors de l’exécution de Visual Studio en tant qu’administrateur: indique à Visual Studio d’essayer de lancer Chrome pendant le débogage JavaScript.

Avertir s’il n’y a pas de symboles lors du lancement (natif uniquement): affiche une boîte de dialogue d’avertissement lorsque vous déboguez un programme pour lequel le débogueur n’a aucune information de symbole.

Avertir si le débogage de script est désactivé lors du lancement: affiche une boîte de dialogue d’avertissement lorsque le débogueur est lancé avec le débogage de script désactivé.

Voir aussi

• Débogage dans Visual Studio
• Premier aperçu du débogueur