/debug (C#-Compileroptionen)

Die Option /debug bewirkt, dass der Compiler Debuginformationen generiert und in die Ausgabedatei(en) einfügt.

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

Argumente

  • + | -
    Wenn Sie + oder nur /debug angeben, generiert der Compiler Debuginformationen und platziert diese in einer Programmdatenbank (PDB-Datei). Wenn Sie - angeben, das wirksam ist, wenn Sie /debug nicht angeben, werden keine Debuginformationen erstellt.

  • full | pdbonly
    Gibt die Art der vom Compiler generierten Debuginformationen an. Das vollständige Argument, das wirksam ist, wenn Sie /debug:pdbonly nicht angeben, ermöglicht das Anfügen eines Debuggers an das laufende Programm. Durch Angeben von pdbonly wird das Debuggen von Quellcode ermöglicht, wenn das Programm im Debugger gestartet wird. Der Assembler wird jedoch nur angezeigt, wenn das laufende Programm an den Debugger angefügt ist.

Hinweise

Verwenden Sie diese Option zum Erstellen von Debugbuilds. Wenn /debug, /debug+ oder /debug:full nicht angegeben sind, können Sie die Ausgabedatei des Programms nicht debuggen.

Beachten Sie bei Verwendung von /debug:full, dass /debug:full größere Auswirkungen auf die Geschwindigkeit und Größe des JIT-optimierten Codes und geringe Auswirkungen auf die Qualität des Codes hat. Sie sollten /debug:pdbonly oder keine PDB für das Generieren von Versionscode verwenden.

Tipp

Ein Unterschied zwischen /debug:pdbonly und /debug:full besteht darin, dass der Compiler bei Verwendung von /debug:full ein DebuggableAttribute ausgibt, anhand dessen dem JIT-Compiler mitgeteilt wird, dass Debuginformationen verfügbar sind. Deshalb erhalten Sie bei Verwendung von /debug:full eine Fehlermeldung, wenn der Code das auf den Wert false festgelegte DebuggableAttribute enthält.

Weitere Informationen zum Konfigurieren der Debugleistung einer Anwendung finden Sie unter Erleichtern des Debuggens für ein Abbild.

Informationen zum Ändern des Speicherorts der PDB-Datei finden Sie unter /pdb (C#-Compileroptionen).

So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest

  1. Öffnen Sie die Eigenschaften-Seite des Projekts.

  2. Klicken Sie auf die Eigenschaftenseite Erstellen.

  3. Klicken Sie auf die Schaltfläche Erweitert.

  4. Ändern Sie die Eigenschaft Debuginfo.

Informationen über das programmgesteuerte Festlegen der Compileroption finden Sie unter DebugSymbols.

Beispiel

In diesem Beispiel werden Debuginformationen in die Ausgabedatei app.pdb eingefügt:

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

Siehe auch

Weitere Ressourcen

C#-Compileroptionen

Projekteigenschaften (Visual Studio)