Szybki start: debugowanie ASP.NET Core za pomocą debugera Visual Studio

W tym przewodniku Szybki start poznasz, jak używać debugera programu Visual Studio do debugowania kodu aplikacji ASP.NET Core. Ten artykuł zawiera szybki sposób na zapoznanie się z niektórymi podstawowymi funkcjami pracy w debugerze.

Jeśli nie masz programu Visual Studio, możesz zainstalować bezpłatną wersję próbną ze strony pobierania programu Visual Studio.

Utwórz nowy projekt

Zacznij od utworzenia nowego projektu, więc masz kod do zaewidencjonowania w debugerze.

  1. Otwórz program Visual Studio i utwórz nowy projekt.

    • Jeśli okno startowe nie jest otwarte, wybierz pozycję Plik>Okno startowe.

    • W oknie startowym wybierz pozycję Utwórz nowy projekt.

  2. W oknie Tworzenie nowego projektu ustaw filtry i wyszukaj szablon projektu.

    • W polu Wyszukaj szablony wpisz aplikacja internetowa.

    • Rozwiń listę rozwijaną Język i wybierz pozycję C#.

  3. Na liście wyników wybierz szablon ASP.NET Core Web App (Razor Pages) szablon języka C#, a następnie wybierz Dalej.

    Jeśli nie widzisz szablonu ASP.NET Core Web App (Razor Pages) dla języka C#, wybierz opcję Continue bez kodu.

    1. Wybierz Tools>Pobierz narzędzia i funkcje... który otwiera Instalator Visual Studio.

    2. W oknie Instalatora zaznacz pole wyboru przy obciążeniu ASP.NET i tworzenie aplikacji internetowych, a następnie wybierz opcję Modyfikuj.

      Instalacja programu Visual Studio zostanie zaktualizowana i będzie obejmować wybrane obciążenie ASP.NET.

    3. Po zakończeniu aktualizacji wybierz Plik>Okno startowe i postępuj zgodnie z poprzednimi instrukcjami, aby wybrać wymagany szablon.

  4. Skonfiguruj nowy projekt:

    1. Wprowadź nazwę Project i Nazwa rozwiązania lub użyj wartości domyślnych.

    2. Użyj domyślnej lokalizacji lub wybierz pozycję Przeglądaj (...), aby utworzyć projekt w innym folderze.

    3. Wybierz Dalej.

    4. Użyj zalecanej platformy docelowej Framework (domyślnie jest to .NET 10.0 LTS).

    5. W przypadku innych ustawień użyj wartości domyślnych.

    6. Wybierz Utwórz.

    Visual Studio tworzy nowy projekt i dodaje pliki projektu w określonym folderze.

Aktualizowanie kodu projektu

Zaktualizuj część kodu dostarczonego przez szablon projektu, aby mieć więcej instrukcji do przetestowania w debugerze.

  1. W okienku Eksplorator rozwiązań rozwiń węzeł <project-name>\Pages i wybierz Privacy.cshtml.

    Plik Privacy.cshtml zostanie otwarty w edytorze kodu.

  2. Znajdź następującą sekcję kodu w pliku i zastąp ją podanym fragmentem kodu:

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

    Fragment kodu zastępczego:

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

  3. W Eksplorator rozwiązań rozwiń węzeł <project-name>\Pages\Privacy.cshtml i wybierz element Privacy.cshtml.cs.

    Plik Privacy.cshtml.cs zostanie otwarty w edytorze kodu.

  4. Znajdź następującą sekcję kodu w pliku i zastąp ją podanym fragmentem kodu:

    public void OnGet()
{
}

    Fragment kodu zastępczego:

    
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;
}

Ustawianie punktu przerwania

breakpoint to znacznik wskazujący, gdzie Visual Studio powinien zawiesić uruchomiony kod. Po ustawieniu punktu przerwania możesz przyjrzeć się bieżącym wartościom zmiennych, sprawdzić zachowanie pamięci i sprawdzić, czy działa określona gałąź kodu. Punkty przerwania to najbardziej podstawowa funkcja debugowania.

  1. Aby ustawić punkt przerwania, znajdź w kodzie wywołanie funkcji DoWork, a następnie kliknij na lewym marginesie przy tym samym wierszu.

    Po ustawieniu punktu przerwania przy odpowiednim wierszu kodu w lewym marginesie pojawia się czerwona kropka.

    Screenshot pokazujący, jak ustawić punkt przerwania w debugerze Visual Studio.

    Screenshot pokazujący, jak ustawić punkt przerwania w debugerze Visual Studio 2022

  2. Rozpocznij debugowanie przy użyciu skrótu klawiaturowego F5 (lub wybierz pozycję Debuguj>rozpocznij debugowanie).

  3. Po otwarciu strony internetowej w oknie przeglądarki wybierz link Prywatność w górnej części strony.

    Wykonywanie kodu jest wstrzymywane bezpośrednio przed wywołaniem DoWork funkcji.

    Debugger zatrzymuje się tam, gdzie ustawiono punkt przerwania. Żółta strzałka identyfikuje instrukcję, w której debuger wstrzymuje wykonywanie aplikacji.

    Screenshot przedstawiający wstrzymany debuger w ustawionym punkcie przerwania w Visual Studio.

    Zrzut ekranu pokazujący debuger zatrzymany na ustawionym punkcie przerwania w Visual Studio 2022.

Ustawianie warunkowych punktów przerwania

Jeśli ustawisz punkt przerwania w pętli lub rekursji lub jeśli masz wiele punktów przerwania, które często przechodzisz, użyj warunkowego punktu przerwania.

Takie podejście pomaga zapewnić, że kod jest zawieszony tylko wtedy, gdy zostaną spełnione określone warunki. Warunkowy punkt przerwania może zaoszczędzić czas, a także ułatwić debugowanie problemów, które są trudne do odtworzenia.

Zapoznaj się z kodem

Visual Studio udostępnia kilka różnych sposobów poinstruowania debugera o kontynuowaniu wykonywania aplikacji. Poniższy przykład przedstawia przydatne polecenie do analizowania kodu krok po kroku.

Gdy kod jest wstrzymany w punkcie przerwania, umieść kursor na instrukcjireturn c2;, aż zobaczysz zieloną ikonę Uruchom, aby kliknąć (uruchom wykonanie tutaj). Wybierz ikonę.

Zrzut ekranu pokazujący, jak używać polecenia „Run to Click” w debugerze programu Visual Studio.

Zrzut ekranu pokazujący, jak używać akcji Uruchom do kliknięcia w debugerze programu Visual Studio 2022.

Aplikacja kontynuuje wykonywanie i wstrzymuje się w wierszu kodu, w którym kliknął przycisk.

Często używane polecenia klawiatury do przechodzenia przez kod to F10 i F11. Aby uzyskać bardziej szczegółowe instrukcje, zobacz Pierwsze spojrzenie na debuger.

Inspekcja zmiennych w podpowiedziach danych

Stan zmiennych można sprawdzić za pomocą funkcji etykiet danych.

  1. W bieżącym wierszu kodu (oznaczonym żółtym wskaźnikiem wykonywania) najedź kursorem na obiekt c2, aby zobaczyć etykietkę danych.

    Screenshot przedstawiający sposób wyświetlania wskazówek dotyczących danych zmiennych kodu w debugerze Visual Studio.

    Screenshot przedstawiający sposób wyświetlania wskazówek dotyczących danych zmiennych kodu w debugerze Visual Studio 2022

    Porada dotycząca danych pokazuje bieżącą wartość zmiennej c2 i umożliwia sprawdzenie jej właściwości.

    Jeśli podczas debugowania widzisz nieoczekiwaną wartość zmiennej, prawdopodobnie występuje usterka. Usterka może znajdować się w kodzie, który wywołuje zmienną lub w poprzednim wierszu.

  2. Rozwiń podpowiedź danych, aby zobaczyć bieżące wartości właściwości obiektu c2.

  3. Aby nadal sprawdzać wartość c2 podczas wykonywania kodu, wybierz ikonę przypięcia na etykiecie danych.

    Akcja przypięcia pozostawia etykietę danych otwartą. W miarę wykonywania kodu wartość przypiętej wskazówki zmienia się, aby pokazać bieżący stan obserwowanego obiektu.

    Przypiętą wskazówkę można przenieść w dowolne miejsce w środowisku IDE, dzięki czemu nie zasłania innych elementów podczas debugowania.

Następny krok

Omówienie debugera programu Visual Studio

  • Last updated on