/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, was im Endeffekt dasselbe ist, wie /debug nicht anzugeben, 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 etwas beeinträchtigen 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 empfehlen wir /debug:pdbonly oder keine PDB-Datei.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 ausgibt, was 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 in Ihrem Code DebuggableAttribute auf FALSE festgelegt ist, wenn Sie /debug:full verwenden.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 Eigenschaften-Seite 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