-debug (Options du compilateur C#)-debug (C# Compiler Options)

L’option -debug fait en sorte que le compilateur génère des informations de débogage et les place dans les fichiers de sortie.The -debug option causes the compiler to generate debugging information and place it in the output file or files.

SyntaxeSyntax

-debug[+ | -]  
-debug:{full | pdbonly}  

ArgumentsArguments

+ | -+ | -
Si vous spécifiez + ou simplement -debug, le compilateur génère des informations de débogage et les place dans un fichier de base de données du programme (.pdb).Specifying +, or just -debug, causes the compiler to generate debugging information and place it in a program database (.pdb file). Si vous spécifiez -, qui est en vigueur si vous ne spécifiez pas -debug, aucune information de débogage n’est créée.Specifying -, which is in effect if you do not specify -debug, causes no debug information to be created.

full | pdbonlyfull | pdbonly
Indique le type d'informations de débogage générées par le compilateur.Specifies the type of debugging information generated by the compiler. L’argument complet, qui est en vigueur si vous ne spécifiez pas -debug:pdbonly, permet d’attacher un débogueur au programme en cours d’exécution.The full argument, which is in effect if you do not specify -debug:pdbonly, enables attaching a debugger to the running program. Le fait de spécifier pdbonly active le débogage du code source quand le programme est démarré dans le débogueur, mais affiche uniquement un assembleur quand le programme en cours d’exécution est attaché au débogueur.Specifying pdbonly allows source code debugging when the program is started in the debugger but will only display assembler when the running program is attached to the debugger.

RemarquesRemarks

Utilisez cette option pour créer des versions Debug.Use this option to create debug builds. Si -debug, -debug+ ou -debug:full n’est pas spécifié, vous ne pourrez pas déboguer le fichier de sortie de votre programme.If -debug, -debug+, or -debug:full is not specified, you will not be able to debug the output file of your program.

Si vous utilisez -debug:full, sachez qu’il y a un impact sur la vitesse et la taille du code optimisé JIT, ainsi qu’un faible impact sur la qualité du code avec -debug:full.If you use -debug:full, be aware that there is some impact on the speed and size of JIT optimized code and a small impact on code quality with -debug:full. Nous vous recommandons d’utiliser -debug:pdbonly ou aucun PDB pour la génération du code de version finale.We recommend -debug:pdbonly or no PDB for generating release code.

Notes

L’une des différences entre -debug:pdbonly et -debug:full est qu’avec -debug:full, le compilateur émet un DebuggableAttribute, qui est utilisé pour signaler au compilateur JIT que des informations de débogage sont disponibles.One difference between -debug:pdbonly and -debug:full is that with -debug:full the compiler emits a DebuggableAttribute, which is used to tell the JIT compiler that debug information is available. Ainsi, une erreur se produit si votre code contient un DebuggableAttribute avec la valeur false si vous utilisez -debug:full.Therefore, you will get an error if your code contains the DebuggableAttribute set to false if you use -debug:full.

Pour plus d’informations sur la façon de configurer les performances de débogage d’une application, consultez Simplification du débogage d’une image.For more information on how to configure the debug performance of an application, see Making an Image Easier to Debug.

Pour changer l’emplacement du fichier .pdb, consultez -pdb (Options du compilateur C#).To change the location of the .pdb file, see -pdb (C# Compiler Options).

Pour définir cette option du compilateur dans l'environnement de développement Visual StudioTo set this compiler option in the Visual Studio development environment

  1. Ouvrez la page Propriétés du projet.Open the project's Properties page.

  2. Cliquez sur la page de propriétés Générer.Click the Build property page.

  3. Cliquez sur le bouton Avancées .Click the Advanced button.

  4. Modifiez la propriété Infos de débogage.Modify the Debug Info property.

Pour plus d’informations sur la définition de cette option du compilateur par programmation, consultez DebugSymbols.For information on how to set this compiler option programmatically, see DebugSymbols.

ExempleExample

Placez les informations de débogage dans le fichier de sortie app.pdb :Place debugging information in output file app.pdb:

csc -debug -pdb:app.pdb test.cs  

Voir aussiSee also