Partager via


/debug (Émettre des informations de débogage) (Options du compilateur C#)

Mise à jour : novembre 2007

Si vous spécifiez l'option /debug, le compilateur génère des informations de débogage et les stocke dans le ou les fichiers de sortie.

/debug[+ | <U>-</U>]
/debug:{<U>full</U> | pdbonly}

Arguments

  • + | -
    Si vous spécifiez + ou simplement /debug, le compilateur générera des informations de débogage et les placera dans une base de données du programme (fichier .pdb). Si vous spécifiez -, qui est appliqué si vous ne spécifiez pas /debug, aucune information de débogage n'est créée.

  • full | pdbonly
    Spécifie le type d'informations de débogage générées par le compilateur. Si vous spécifiez l'argument full ou si vous ne spécifiez pas /debug:pdbonly, un débogueur sera attaché au programme en cours d'exécution. La spécification de pdbonly permet un débogage du code source lorsque le programme est démarré dans le débogueur, mais affiche du code en langage assembleur uniquement lorsque le programme en cours d'exécution est attaché au débogueur.

Notes

Utilisez cette option pour créer des générations de débogage. Si vous ne spécifiez pas /debug, /debug+ ou /debug:full, vous ne pourrez pas déboguer le fichier de sortie de votre programme.

Si vous utilisez /debug:full, sachez qu'il existe un impact sur la vitesse et sur la taille de code optimisé JIT, ainsi qu'un faible impact sur la qualité du code en cas d'utilisation de /debug:full. Nous recommandons l'utilisation de /debug:pdbonly ou d'aucun PDB pour la génération du code de version finale.

Remarque :

Une différence entre /debug:pdbonly et /debug:full est qu'avec /debug:full le compilateur émet un DebuggableAttribute, qui est utilisé pour indiquer au compilateur JIT que les informations de débogage sont disponibles. Par conséquent, vous obtiendrez une erreur si votre code contient le jeu DebuggableAttribute défini à la valeur false si vous utilisez /debug:full.

Pour plus d'informations sur la configuration des performances de débogage d'une application, consultez Simplification du débogage d'une image.

Pour modifier l'emplacement du fichier .pdb, consultez /pdb (Spécifier un fichier de symboles pour le débogage) (Options du compilateur C#).

Pour définir cette option du compilateur dans l'environnement de développement Visual Studio

  1. Ouvrez la page Propriétés du projet.

  2. Cliquez sur la page de propriétés Générer.

  3. Cliquez sur le bouton Avancé.

  4. Modifiez la propriété Infos de débogage.

Pour plus d'informations sur la définition de cette option du compilateur par programme, consultez DebugSymbols.

Exemple

Placez des informations de débogage dans le fichier de sortie app.pdb :

csc /debug /out:app.pdb test.cs

Voir aussi

Autres ressources

Options du compilateur C#

Propriétés de projet (Visual Studio)