Schnellstart: Debuggen von ASP.NET Core mit dem Visual Studio Debugger

In dieser Schnellstartanleitung erfahren Sie, wie Sie den Visual Studio Debugger verwenden, um Ihren ASP.NET Core Anwendungscode zu debuggen. Dieser Artikel bietet eine schnelle Möglichkeit, einige der grundlegenden Features für die Arbeit im Debugger kennenzulernen.

Wenn Sie nicht über Visual Studio verfügen, können Sie die free-Testversion installieren auf der Seite Visual Studio Downloads.

Erstellen eines neuen Projekts

Erstellen Sie zunächst ein neues Projekt, damit Sie etwas Code haben, den Sie im Debugger überprüfen können.

1. Öffnen Sie Visual Studio, und erstellen Sie ein neues Projekt.

   • Wenn das Startfenster nicht geöffnet ist, wählen Sie ">" aus.

   • Wählen Sie im Startfenster "Neues Projekt erstellen" aus.

2. Legen Sie im Fenster " Neues Projekt erstellen " die Filter fest, und suchen Sie nach einer Projektvorlage.

   • Geben Sie im Feld Nach Vorlagen suchenWeb-App ein.

   • Erweitern Sie das Dropdownmenü "Sprache ", und wählen Sie "C#" aus.

3. Wählen Sie in der Ergebnisliste die Vorlage ASP.NET Core Web App (Razor Pages) für C# aus, und wählen Sie dann Next aus.

   Wenn die Vorlage ASP.NET Core Web App (Razor Pages) für C# nicht angezeigt wird, wählen Sie die Option Continue ohne Code aus.

   1. Wählen Sie Tools>Get Tools and Features aus... , wodurch das Visual Studio Installer geöffnet wird.

   2. Aktivieren Sie im Installerfenster das Kontrollkästchen für die Workload ASP.NET und Webentwicklung, und wählen Sie dann Ändern aus.

      Ihre Visual Studio-Installation wird aktualisiert, um die ausgewählte ASP.NET-Workload einzuschließen.

   3. Nachdem das Update abgeschlossen ist, wählen Sie "Dateistartfenster>" aus, und folgen Sie den vorherigen Anweisungen, um die erforderliche Vorlage auszuwählen.

4. Konfigurieren Sie das neue Projekt:

   1. Geben Sie einen Projektnamen und einen Lösungsnamen ein, oder verwenden Sie die Standardwerte.

   2. Verwenden Sie den Standardspeicherort , oder wählen Sie "Durchsuchen" (...) aus, um das Projekt in einem anderen Ordner zu erstellen.

   3. Wählen Sie Weiteraus.

   4. Verwenden Sie das empfohlene Ziel Framework (der Standardwert ist .NET 10,0 Long Term Support).

   5. Verwenden Sie für die anderen Einstellungen die Standardwerte.

   6. Wählen Sie "Erstellen" aus.

   Visual Studio erstellt Ihr neues Projekt und fügt die Projektdateien im angegebenen Ordner hinzu.

Aktualisieren des Projektcodes

Aktualisieren Sie einen Teil des Codes, der von der Projektvorlage bereitgestellt wird, damit Sie weitere Anweisungen zum Testen im Debugger haben.

1. Erweitern Sie im Bereich Projektmappen-Explorer den Knoten <project-name>\Pages, und wählen Sie das Element Privacy.cshtml aus.

   Die Datei Privacy.cshtml wird im Code-Editor geöffnet.

2. Suchen Sie den folgenden Codeabschnitt in der Datei, und ersetzen Sie ihn durch den bereitgestellten Codeausschnitt:

   @{
    ViewData["Title"] = "Privacy Policy";
   }
   

   Ersetzungsausschnitt:

   @{
    ViewData["Title"] = "Privacy Policy";
    <label>@PrivacyModel.PrivacyMessage</label>
   }
   

3. Erweitern Sie in Projektmappen-Explorer den Knoten <projektname>\Pages\Privacy.cshtml, und wählen Sie das Element Privacy.cshtml.cs aus.

   Die Privacy.cshtml.cs Datei wird im Code-Editor geöffnet.

4. Suchen Sie den folgenden Codeabschnitt in der Datei, und ersetzen Sie ihn durch den bereitgestellten Codeausschnitt:

   public void OnGet()
   {
   }
   

   Ersatzausschnitt:

   
   public static string? PrivacyMessage { get; set; }
   
   public void OnGet() {
      LinkedList<int> result = DoWork();
   
      PrivacyMessage = "Result of work: " + result.First.Value + ", " + result.First.Value;
   }
   
   private static LinkedList<int> DoWork() {
      LinkedList<int> c1 = new();
   
      c1.AddLast(10);
      c1.AddLast(20);
   
      LinkedList<int> c2 = new(c1);
      return c2;
   }
   

Haltepunkt festlegen

Ein breakpoint ist eine Markierung, die angibt, wo Visual Studio den ausgeführten Code anhalten soll. Wenn ein Haltepunkt festgelegt ist, können Sie sich die aktuellen Werte von Variablen ansehen, das Verhalten des Arbeitsspeichers untersuchen und überprüfen, ob ein bestimmter Codezweig ausgeführt wird. Haltepunkte sind das grundlegendste Feature beim Debuggen.

1. Um einen Breakpoint zu setzen, suchen Sie den Aufruf der Funktion DoWork im Code und klicken Sie dann in der linken Randleiste auf dieselbe Zeile.

   Wenn der Haltepunkt gesetzt ist, wird am linken Rand in der entsprechenden Codezeile ein roter Punkt angezeigt.

   

   

2. Starten Sie das Debuggen mithilfe der F5-Tastenkombination (oder wählen Sie "Debuggen>starten" aus).

3. Wenn die Webseite im Browserfenster geöffnet wird, wählen Sie oben auf der Seite den Link " Datenschutz" aus.

   Die Codeausführung wird unmittelbar vor dem Aufruf der DoWork Funktion angehalten.

   Der Debugger hält an dem Breakpoint an, den Sie festlegen. Ein gelber Pfeil kennzeichnet die Anweisung, bei der der Debugger die Ausführung der App anhält.

   

   

Festlegen von bedingten Haltepunkten

Wenn Sie einen Haltepunkt in einer Schleife oder Rekursion festlegen oder viele Haltepunkte haben, die Sie häufig durchlaufen, verwenden Sie einen bedingten Haltepunkt.

Mit diesem Ansatz wird sichergestellt, dass Ihr Code nur angehalten wird, wenn bestimmte Bedingungen erfüllt sind. Ein bedingter Haltepunkt kann Zeit sparen und das Debuggen von Problemen erleichtern, die schwer zu reproduzieren sind.

Ihren Code durchgehen

Visual Studio bietet verschiedene Möglichkeiten zum Anweisen des Debuggers, mit der App-Ausführung fortzufahren. Das folgende Beispiel zeigt einen nützlichen Befehl zum Durchlaufen des Codes.

Während der Code am Haltepunkt angehalten ist, bewegen Sie den Mauszeiger auf die Anweisung return c2;, bis das grüne Symbol Ausführen bis zum Klick (Ausführung bis hierher) angezeigt wird. Wählen Sie das Symbol aus.

Die App setzt die Ausführung fort und hält an der Codezeile an, an der Sie auf die Schaltfläche geklickt haben.

Allgemeine Tastaturbefehle, die zum Schrittweisen Durchlaufen von Code verwendet werden, umfassen F10 und F11. Ausführlichere Anweisungen finden Sie unter "Erster Blick auf den Debugger".

Überprüfen von Variablen in einem Datentipp

Sie können den Status Ihrer Variablen mithilfe der Datentippfunktion überprüfen.

1. Zeigen Sie in der aktuellen Codezeile (gekennzeichnet durch den gelben Ausführungspunkt) mit der Maus auf das c2 Objekt, um den Datentipp anzuzeigen.

   

   

   Der Datentipp zeigt Ihnen den aktuellen Wert der c2 Variablen an und ermöglicht es Ihnen, deren Eigenschaften zu überprüfen.

   Wenn beim Debuggen ein unerwarteter Wert für eine Variable angezeigt wird, liegt wahrscheinlich ein Fehler vor. Der Fehler könnte im Code enthalten sein, der den Aufruf der Variablen oder in der vorherigen Zeile vorgibt.

2. Erweitern Sie den Datentipp, um die aktuellen Eigenschaftswerte des c2 Objekts anzuzeigen.

3. Um den Wert der Ausführung des c2 Codes weiterhin zu überprüfen, wählen Sie das Pinsymbol auf der Datenspitze aus.

   Die Pin-Aktion hält den Datentipp geöffnet. Während der Code ausgeführt wird, ändert sich der Wert in der angehefteten Info so, dass der aktuelle Zustand des überwachten Objekts angezeigt wird.

   Sie können den angehefteten Hinweis an eine beliebige Position in der IDE verschieben, sodass er Sie beim Debuggen nicht daran hindert, andere Elemente im Blick zu behalten.

Nächster Schritt