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 de 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 l’Explorateur de solutions, puis l’icône Propriétés ou cliquez avec le bouton droit sur le projet et sélectionnez Propriétés.
Pour plus d’informations, consultez Configurations Debug et Release.
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+)
| Paramètre | 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 correspond au 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 l’ordinateur distant | 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)
En plus des propriétés pour .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 suivants.
| Paramètre | Description |
|---|---|
| Lancer le navigateur | Sélectionnez si vous souhaitez 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é d’après le projet (autrement dit, la propriété commandName dans launchSettings.json est Project), le serveur Kestrel est à l’écoute du 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 d’application. Pour un profil nommé d’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 dans launchSettings.json. Ces deux types de profils fournissent plusieurs paramètres, tels que le modèle d’hébergement.
| Paramètre | Description |
|---|---|
| Modèle d’hébergement | Spécifiez En cours (par défaut) ou Hors processus. 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éralementhttp://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 build, consultez Page de build, Concepteur de projets.
| Paramètre | Description |
|---|---|
| Général>Symboles de compilation conditionnelle | Définissez les constantes DEBUG et TRACE si cette option est sélectionnée. Ces constantes activent 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 un résultat dans la fenêtre Sortie. Sans ces constantes, les méthodes de classe Debug et Trace ne sont pas compilées et aucun résultat n’est généré. 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 | À moins qu’un bogue apparaisse 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 dans le code source. |
| Symboles de débogage | Indique 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 Simplification du débogage d’une image. |
| 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
Génère un fichier .PDB, un fichier de symboles spécifique à la plateforme qui fournit d’autres outils, notamment des débogueurs, des informations sur les éléments dans le fichier exécutable principal et la façon dont il a été produit.
Fichier PDB, portable
Génère un fichier .PDB, un fichier de symboles portable non spécifique à la plateforme qui fournit d’autres outils, notamment des débogueurs, des informations sur les éléments dans le fichier exécutable principal et la façon dont il a été produit. Pour plus d’informations, consultez PDB portable.
Incorporé dans DLL/EXE, portable sur toutes les 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#).