-debug (C#-Compileroptionen)-debug (C# Compiler Options)

Die Option -debug führt dazu, dass der Compiler Debuginformationen generiert und sie in der Ausgabedatei bzw. in Ausgabedateien platziert.The -debug option causes the compiler to generate debugging information and place it in the output file or files.

SyntaxSyntax

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

ArgumenteArguments

+ | -+ | -
Wenn + oder nur -debug angegeben wird, generiert der Compiler Debuginformationen und platziert sie in einer Programmdatenbank (PDB-Datei).Specifying +, or just -debug, causes the compiler to generate debugging information and place it in a program database (.pdb file). Wenn Sie - angeben (entspricht dem Weglassen von -debug), werden keine Debuginformationen erstellt.Specifying -, which is in effect if you do not specify -debug, causes no debug information to be created.

full | pdbonlyfull | pdbonly
Gibt den Typ der Debuginformationen an, die vom Compiler generiert werden.Specifies the type of debugging information generated by the compiler. Das vollständige Argument, das aktiv ist, wenn Sie -debug:pdbonly nicht angeben, ermöglicht das Anfügen eines Debuggers an das ausgeführte Programm.The full argument, which is in effect if you do not specify -debug:pdbonly, enables attaching a debugger to the running program. Durch die Angabe von pdbonly wird das Debuggen von Quellcode möglich, wenn das Programm im Debugger gestartet wird. Der Assembler wird jedoch nur angezeigt, wenn das aktive Programm an den Debugger angefügt ist.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.

HinweiseRemarks

Verwenden Sie diese Option, um Debugbuilds zu erstellen.Use this option to create debug builds. Wenn -debug, -debug+ oder -debug:full nicht angegeben ist, können Sie die Ausgabedatei Ihres Programms nicht debuggen.If -debug, -debug+, or -debug:full is not specified, you will not be able to debug the output file of your program.

Wenn Sie -debug:full verwenden, beachten Sie, dass dies Einfluss auf die Geschwindigkeit und Größe von optimiertem JIT-Code hat und die Codequalität mit -debug:full beeinträchtigt sein kann.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. Zum Generieren von Releasecode wird empfohlen, -debug:pdbonly oder keine PDB-Datei zu verwenden.We recommend -debug:pdbonly or no PDB for generating release code.

Hinweis

Ein Unterschied zwischen -debug:pdbonly und -debug:full besteht darin, dass der Compiler mit -debug:full ein DebuggableAttribute-Objekt ausgibt, das dem JIT-Compiler mitteilt, dass die Debuginformation verfügbar ist.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. Deshalb wird ein Fehler ausgegeben, wenn bei der Verwendung von -debug:full DebuggableAttribute in Ihrem Code auf FALSE festgelegt ist.Therefore, you will get an error if your code contains the DebuggableAttribute set to false if you use -debug:full.

Weitere Informationen zur Konfiguration der Leistung einer Anwendung beim Debuggen finden Sie unter Erleichtern des Debuggens für ein Image.For more information on how to configure the debug performance of an application, see Making an Image Easier to Debug.

Informationen zum Ändern des Speicherorts der PDB-Datei finden Sie unter -pdb (C#-Compileroptionen).To change the location of the .pdb file, see -pdb (C# Compiler Options).

So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung festTo set this compiler option in the Visual Studio development environment

  1. Öffnen Sie die Seite Eigenschaften des Projekts.Open the project's Properties page.

  2. Klicken Sie auf die Eigenschaftenseite Build .Click the Build property page.

  3. Klicken Sie auf die Schaltfläche Erweitert .Click the Advanced button.

  4. Ändern Sie die Eigenschaft der Debuginformation.Modify the Debug Info property.

Informationen zum programmgesteuerten Festlegen dieser Compileroption finden Sie unter DebugSymbols.For information on how to set this compiler option programmatically, see DebugSymbols.

BeispielExample

Platzieren Sie die Debuginformationen in der Ausgabedatei app.pdb:Place debugging information in output file app.pdb:

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

Siehe auchSee Also

C#-CompileroptionenC# Compiler Options
Verwalten von Projekt- und ProjektmappeneigenschaftenManaging Project and Solution Properties