Freigeben über

Anwendungsbeispiel für Debuggeransichten

  • Artikel

Aktualisiert: November 2007

In diesem Beispiel wird ein mit Microsoft Visual Studio 2005 eingeführtes Feature veranschaulicht: die Fähigkeit, die Art und Weise der Anzeige einer Klasse in den Debugfenstern zu ändern. Durch das Anwenden der neuen Attribute, z. B. DebuggerDisplayAttribute, auf eine Klasse und ihre Member können Sie steuern, wie die Wert-, Typ- und Namensspalten für diesen Typ im Debugfenster Lokal angezeigt werden und ob ein Wert angezeigt, verborgen oder bei der Anzeige erweitert wird. Dieses Beispiel ist gegenwärtig nur in Microsoft Visual C# 2005 verfügbar.

Informationen zur Verwendung der Beispiele finden Sie unter den folgenden Themen:

Dieses Beispiel umfasst Quelldateien für drei Klassen, die die Debuggerattribute enthalten, und Quelldateien, die keine Debuggerattribute enthalten, wie in der folgenden Tabelle dargestellt.

Dateien mit Debuggerattributen

Dateien ohne Debuggerattribute

DebugAddress.cs

NonDebugAddress.cs

DebugCustomer.cs

NonDebugCustomer.cs

DebugCustomerName.cs

NonDebugCustomerName.cs

Die Datei DebuggerViewsExample.cs enthält den Einstiegspunkt der Konsolenanwendung und wird von beiden Gruppen von Dateien verwendet. Heben Sie die Auskommentierung des Codes in den Debugversionen (DebugAddress.cs, DebugCustomer.cs und DebugCustomerName.cs) auf, um das Beispiel auszuführen.

Download sample

So erstellen Sie das Beispiel mithilfe der Eingabeaufforderung

  1. Öffnen Sie ein Eingabeaufforderungsfenster, und navigieren Sie zum Unterverzeichnis \CS unter dem Verzeichnis DebuggerViewsCS. Informationen zu erforderlichen Einstellungen sowie zur SDK-Eingabeaufforderung finden Sie unter Gewusst wie: Festlegen der Beispieleinstellungen.

  2. Geben Sie msbuild DebuggerViewsCS.sln in der Befehlszeile ein.

    Hinweis:

    In diesem Beispiel werden Features von Visual Studio veranschaulicht. Sie müssen es in der Debugumgebung von Visual Studio starten und ausführen, um seine Ausgabe anzeigen zu können.

So erstellen Sie das Beispiel mithilfe von Visual Studio

  1. Öffnen Sie Windows Explorer, und navigieren Sie im Verzeichnis DebuggerViewsCS zum Unterverzeichnis \CS.

  2. Doppelklicken Sie auf DebuggerViewsCS.sln, um die Datei in Visual Studio 2005 zu öffnen.

  3. Klicken Sie im Menü Erstellen auf Projektmappe erstellen.

So führen Sie das Beispiel aus

  1. Klicken Sie in Visual Studio im Menü Ansicht auf Projektmappen-Explorer.

  2. Doppelklicken Sie im Fenster Projektmappen-Explorer auf DebuggerViewsExample.cs, um die Datei in Visual Studio 2005 zu öffnen.

  3. Klicken Sie im Menü Projekt auf Alle Dateien anzeigen.

  4. Fügen Sie in der Zeile, in der die GetCustomers-Methode eine Variable vom Typ Customer instanziiert, einen Haltepunkt ein (drücken Sie F9), wie im Folgenden dargestellt:

    Customer c = new Customer(cn, Address.GetAddressById(customerAddresses, cn.Id));

  5. Drücken Sie F5, um die Beispielanwendung in der Visual Studio 2005-Debugumgebung zu starten und auszuführen.

  6. Wenn die Anwendung am Haltepunkt unterbrochen wird, drücken Sie F10, um die nächste Codezeile als Einzelschritt auszuführen.

  7. Zeigen Sie die aktuellen Werte im Fenster Lokal an, indem Sie die Hierarchie der Eigenschaften, Auflistungen und anderer Objekte der Anwendung erweitern. Um das Fenster Lokal anzuzeigen, klicken Sie im Menü Debuggen auf Fenster und dann auf Lokal.

  8. Klicken Sie im Menu Debuggen auf Debuggen beenden, drücken Sie UMSCHALT+F5, oder klicken Sie auf das Symbol in der Debugsymbolleiste, um die Codeausführung zu beenden.

  9. Heben Sie die Auskommentierung des Codes in den drei Dateien auf, deren Namen mit Debug beginnen. Kommentieren Sie anschließend den Code in den drei Dateien aus, deren Namen mit NonDebug beginnen, oder wählen Sie diese drei Dateien im Fenster Projektmappen-Explorer aus, klicken Sie mit der rechten Maustaste, und klicken Sie dann auf Aus Projekt ausschließen.

  10. Wählen Sie mit dem gleichen festgelegten Haltepunkt im Menü Debuggen die Option Starten aus. Wenn die Anwendung unterbrochen wird, beachten Sie die Informationen in der Wertespalte des Fensters Lokal, die jetzt weitere Informationen enthält, die durch Debugattribute bereitgestellt wurden.

Hinweise

Um ein Beispiel für die Verwendung eines Debugattributs bereitzustellen, enthält die Datei DebugCustomer.cs das folgende DebuggerDisplay-Attribut für die CustomerName-Klasse:

[DebuggerDisplay("{(FirstName == null) ? \"\":FirstName} {LastName} ==> (Customer ID = {Id})")]

Beim Debuggen wird für dieses Attribut im Fenster Lokal der folgende Wert angezeigt. Der Name cn steht für eine Instanz eines CustomerName-Objekts.

Name

Value

Type

cn

"Sally" "HighBridge" ==> (Customer ID = 12345)

Microsoft.Samples.CustomerName

Ohne das Attribut wird im Fenster Lokal Folgendes angezeigt:

Name

Value

Type

cn

{Microsoft.Samples.CustomerName}

Microsoft.Samples.CustomerName

Siehe auch

Weitere Ressourcen

Debuggen in Visual Studio