Paramètres de projet pour les configurations de débogage C# (.NET Core, .NET 5+ et ASP.NET Core)
Vous pouvez modifier les paramètres de débogage d’un projet C# sous l’onglet Déboguer et l’onglet Générer des pages de propriétés du projet.
Pour ouvrir les pages de propriétés, sélectionnez le projet dans Explorateur de solutions, puis sélectionnez l’icône Propriétés, ou cliquez avec le bouton droit sur le projet, puis sélectionnez Propriétés.
Pour plus d’informations, consultez Configurations de débogage et de mise en production.
Important
Ces paramètres ne s’appliquent pas aux applications .NET Framework ou UWP. Pour configurer les paramètres de débogage pour .NET Framework, consultez Paramètres de projet pour les configurations de débogage C#.
Onglet Déboguer
À compter de Visual Studio 2022, choisissez Ouvrir l’interface utilisateur des profils de lancement de débogage sous l’onglet Déboguer pour ouvrir l’interface utilisateur des profils de lancement et modifier les paramètres de débogage.
Profil de lancement (.NET Core, .NET 5+)
| Réglage | Description |
|---|---|
| Arguments de ligne de commande | Spécifie les arguments de ligne de commande pour l’application en cours de débogage. Le nom de la commande est le nom de l’application spécifié dans Démarrer le programme externe. |
| répertoire de travail | Spécifie le répertoire de travail de l’application en cours de débogage. En C#, le répertoire de travail est \bin\debug par défaut. |
| Utiliser une machine distante | Pour le débogage à distance, sélectionnez cette option et entrez le nom de la cible de débogage à distance, ou un nom de serveur Msvsmon . L’emplacement d’une application sur l’ordinateur distant est spécifié par la propriété chemin de sortie sous l’onglet Générer. L’emplacement doit être un répertoire partageable sur l’ordinateur distant. |
| variables d’environnement | Définit les variables d’environnement avant d’exécuter le processus d’application. Pour ASP.NET Core, consultez Environnements. |
| Activer le débogage de code non managé | Débogue les appels au code Win32 natif (non managé) à partir de l’application managée. |
| Activer le débogage SQL Server | Débogue les objets de base de données SQL Server. |
| Activer le débogage WebView2 | Débogue JavaScript avec le débogueur basé sur Microsoft Edge (Chromium). |
Profil de lancement (ASP.NET Core)
Outre les propriétés de .NET 5+, les profils de lancement ASP.NET Core incluent plusieurs propriétés supplémentaires pour les différents profils ASP.NET Core. Ces paramètres fournissent une interface utilisateur simple pour le fichier launchSettings.json du projet. Pour plus d’informations sur ce fichier, consultez la section Développement et launchSettings.json dans Utiliser plusieurs environnements dans ASP.NET Core.
Les paramètres fournis dans l’interface utilisateur des profils de lancement incluent les éléments suivants.
| Réglage | Description |
|---|---|
| Lancer le navigateur | Indiquez s’il faut lancer le navigateur par défaut lorsque vous démarrez le débogage, à l’aide de l’URL que vous avez définie dans le paramètre Url. |
| url | Spécifie l’emplacement de l’URL de l’hôte pour .NET ou .NET Core. Pour un profil nommé après le projet (autrement dit, la propriété commandName dans launchSettings.json est Project), le serveur Kestrel écoute le port spécifié. Pour un profil IIS, il s’agit généralement de la même valeur que l’URL de l’application . Pour plus d’informations, consultez la section profil de lancement IIS sous Configurer le projet. |
| URL de l’application | Spécifie la ou les URL de l’application. Pour un profil nommé après le projet, cette propriété spécifie les URL du serveur Kestrel, généralement https://localhost:5001 et http://localhost:5000. |
Visual Studio fournit un profil IIS Express par défaut et vous pouvez créer des profils supplémentaires tels qu’un profil IIS. Ces paramètres correspondent également aux paramètres de launchSettings.json. Ces deux types de profils fournissent plusieurs paramètres, tels que le modèle d’hébergement.
| Réglage | Description |
|---|---|
| modèle d’hébergement | Spécifiez In Process (valeur par défaut) ou Out of Process. Pour plus d’informations, consultez modèles d’hébergement dans la documentation ASP.NET Core. |
| URL SSL de l’application | Pour IIS Express, l’URL SSL de l’application est généralement http://localhost:44334. |
Onglet Générer
Le tableau suivant présente les paramètres de build utiles pour le débogage. Pour obtenir une explication complète des paramètres de compilation, consultez la page de compilation , Project Designer.
| Réglage | Description |
|---|---|
| général>symboles de compilation conditionnelle | Définissez les constantes DEBUG et TRACE si elles sont sélectionnées. Ces constantes permettent la compilation conditionnelle de la classe Debug et de la classe Trace . Avec ces constantes définies, les méthodes de classe Debug et Trace génèrent la sortie dans la fenêtre sortie . Sans ces constantes, les méthodes de classe Debug et Trace ne sont pas compilées et aucune sortie n’est générée. Généralement, DEBUG est défini dans la version de débogage d’un build et n’est pas défini dans la version de mise en production. TRACE est défini dans les versions de débogage et de mise en production. |
| >Général Optimiser le code | Sauf si un bogue apparaît uniquement dans le code optimisé, laissez ce paramètre désélectionné pour les builds de débogage. Le code optimisé est plus difficile à déboguer, car les instructions ne correspondent pas directement aux instructions du code source. |
| Symboles de débogage | Spécifie le type d’informations de débogage générées par le compilateur. Consultez Symboles de débogage. Pour plus d’informations sur la configuration des performances de débogage d’une application, consultez Rendre une image plus facile à déboguer. |
| Sortie>Chemin de sortie de base | Spécifie le dossier de base pour la sortie intermédiaire. La sortie est généralement envoyée à bin\Debug pour un build de débogage. |
| Sortie>Chemin de sortie intermédiaire de base | Spécifie le dossier de base pour la sortie intermédiaire. La sortie est généralement envoyée à obj\Debug pour un build de débogage. |
Symboles de débogage
Vous pouvez choisir les options suivantes pour les symboles de débogage.
Aucun symbole n’est émis
Spécifie que les informations de débogage ne doivent pas être générées.
fichier PDB , plateforme actuelle
Produit un fichier .PDB, un fichier de symboles spécifique à la plate-forme qui fournit à d'autres outils, en particulier les débogueurs, des informations sur ce qui se trouve dans le fichier exécutable principal et la façon dont il a été produit.
Fichier PDB, portable
Produit un fichier .PDB, un fichier de symboles portables, non spécifique à une plate-forme, qui fournit à d'autres outils, en particulier les débogueurs, des informations sur le contenu du fichier exécutable principal et la manière dont il a été produit. Pour plus d’informations, consultez Portable PDB .
Incorporé dans DLL/EXE, portable sur plusieurs plateformes
Incorpore les informations de symboles portables dans l’assembly. Aucun fichier .PDB externe n'est produit.
Pour plus d’informations, consultez /debug (options du compilateur C#).