CLR-Debugger (DbgCLR.exe)
Das Microsoft CLR Debugger-Tool (DbgCLR.exe) stellt innerhalb einer grafischen Oberfläche umfangreiche Dienste für das Debuggen zur Verfügung. Anwendungsentwickler können damit Fehler in Programmen, die mit der Common Language Runtime arbeiten, finden und beheben. CLR-Debugger und die beiliegende Dokumentation basieren auf dem Debugger von Microsoft Visual Studio 2005. Daher bezieht sich die Dokumentation in den meisten Fällen auf den Visual Studio-Debugger und nicht direkt auf das CLR Debugger-Tool. In den meisten Fällen gelten die Informationen für beide Debugger. Es gibt jedoch Abschnitte innerhalb der Dokumentation, in denen bestimmte Features beschrieben werden, die nicht im CLR Debugger-Tool implementiert sind (siehe nächster Absatz). Diese Features und Abschnitte können Sie ignorieren.
Im Folgenden werden einige der Hauptunterschiede zwischen dem CLR Debugger-Tool und dem Visual Studio Debugger genannt, die auch in der Dokumentation beschrieben werden:
Das CLR Debugger-Tool unterstützt nicht das Debuggen von Anwendungen, die auf systemeigenem Code von Win32 basieren. Mit dem CLR Debugger-Tool kann das Debuggen nur für Anwendungen durchgeführt werden, die für die Common Language Runtime geschrieben und kompiliert wurden.
Remotedebuggen ist mit dem CLR Debugger-Tool nicht möglich.
Das Fenster Register wird im CLR Debugger implementiert, im Fenster werden jedoch keine Registerinformationen angezeigt. Andere Operationen in Zusammenhang mit Registern oder Pseudoregistern, z. B. das Anzeigen oder Ändern eines Registerwerts, werden nicht unterstützt. Weitere Informationen finden Sie unter Gewusst wie: Verwenden des Fensters "Register".
Das Disassemblyfenster ist im CLR-Debugger implementiert. Es zeigt jedoch nicht den Common Language Runtime-Code, sondern den disassemblierten Code an, der für die Anwendung generiert wird, wenn sie als systemeigener Code von Win32 kompiliert wird. Weitere Informationen finden Sie unter Gewusst wie: Verwenden des Fensters "Disassembly".
Die F1-Hilfefunktion wird vom CLR Debugger-Tool nicht unterstützt.
Das Auto-Fenster wird von CLR-Debugger nicht unterstützt.
Modell einer CLR-Debugger-Projektmappe
Das CLR Debugger-Tool verwendet Projektmappen, um Quelldateien mit den Anwendungen zu verknüpfen, für die aktuell ein Debug durchgeführt wird. Eine Projektmappe wird automatisch beim Öffnen einer kompilierten Anwendung und der verknüpften Quelldateien erstellt. Beim nächsten Debuggen derselben Anwendung können Sie die Projektmappe öffnen und müssen nicht mehr die Quelldatei und die kompilierte Anwendung separat laden.
So öffnen Sie eine Anwendung (erstmalig) zum Debuggen
Starten Sie CLR-Debugger, indem Sie die Datei DbgCLR.exe ausführen. Diese befindet sich im Verzeichnis GuiDebug der .NET Framework-Installation.
Wählen Sie im Menü Debuggen die Option Zu debuggendes Programm aus.
Wechseln Sie im Dialogfeld Zu debuggendes Programm zum Feld Programm, und klicken Sie auf die Schaltfläche mit den Auslassungszeichen (…). Das Dialogfenster Programm finden, das debugged werden soll wird angezeigt.
Navigieren Sie zu dem Verzeichnis, das die zu debuggende EXE-Datei enthält, und wählen Sie die EXE-Datei.
Klicken Sie auf Öffnen.
Das Dialogfeld Zu debuggendes Programm wird wieder angezeigt. Beachten Sie, dass als Arbeitsverzeichnis das Verzeichnis festgelegt wurde, das die EXE-Datei enthält.
Geben Sie im Feld Argumente alle für das Programm erforderlichen Argumente ein.
Klicken Sie auf OK.
Wählen Sie im Menü Datei den Befehl Öffnen, und klicken Sie dann auf Datei.
Wählen Sie im Dialogfeld Datei öffnen die zu öffnende Quelldatei aus.
Klicken Sie auf OK.
Wiederholen Sie die Schritte 8 - 10, um zusätzliche Quelldateien zu öffnen.
Bei diesem Prozess wird automatisch eine Projektmappe für die Debugsitzung erstellt. Wenn Sie Starten oder Schritt auswählen, wird das Dialogfeld Datei speichern unter geöffnet, in dem Sie die Projektmappe speichern können. Wenn Sie Beenden oder Projektmappe schließen auswählen, werden Sie in einem Meldungsfenster aufgefordert, die Projektmappe zuerst zu speichern.
So öffnen Sie eine vorhandene Projektmappe
- Wählen Sie im Menü Datei den Befehl Öffnen.