Samouczek: debugowanie aplikacji konsolowej .NET przy użyciu programu Visual Studio Code

W tym samouczku przedstawiono narzędzia debugowania dostępne w programie Visual Studio Code do pracy z aplikacjami platformy .NET.

Warunki wstępne

• Ten samouczek współpracuje z aplikacją konsolową utworzoną w Tworzenie aplikacji konsolowej platformy .NET przy użyciu programu Visual Studio Code.

Użyj konfiguracji kompilacji Debug

Debug i Release to wbudowane konfiguracje kompilacji platformy .NET. Konfiguracja buildu Debug służy do debugowania, a konfiguracja Release do końcowej dystrybucji.

W konfiguracji debugowania program jest kompilowany z pełnymi symbolicznymi informacjami debugowania i bez optymalizacji. Optymalizacja komplikuje debugowanie, ponieważ relacja między kodem źródłowym i wygenerowanymi instrukcjami jest bardziej złożona. Konfiguracja wydania programu nie zawiera żadnych symbolicznych informacji debugowania i jest w pełni zoptymalizowana.

Domyślnie ustawienia uruchamiania programu Visual Studio Code używają konfiguracji kompilacji debugowania, więc nie trzeba jej zmieniać przed debugowaniem.

1. Uruchom program Visual Studio Code.

2. Otwórz folder projektu utworzonego w Utwórz aplikację konsolową platformy .NET przy użyciu programu Visual Studio Code.

Ustawianie punktu przerwania

punkt przerwania tymczasowo przerywa wykonywanie aplikacji przed uruchomieniem wiersza z punktem przerwania.

1. Otwórz plik Program.cs.

2. Ustaw punkt przerwania w wierszu, który wyświetla nazwę, datę i godzinę, klikając w lewym marginesie okna z kodem. Lewy margines znajduje się po lewej stronie numerów wierszy. Inne sposoby ustawiania punktu przerwania polegają na naciśnięciu F9 lub wybraniu Uruchom>Przełącz punkt przerwania z menu podczas wybierania wiersza kodu.

   Program Visual Studio Code wskazuje wiersz, w którym ustawiono punkt przerwania, wyświetlając czerwoną kropkę na lewym marginesie.

   zestaw punktów przerwania

Rozpocznij debugowanie

1. Otwórz widok Debuguj, wybierając ikonę Debugowanie w menu po lewej stronie.

   

2. Wybierz pozycję Uruchom i debuguj. Jeśli zostaniesz poproszony, wybierz pozycję C#, a następnie wybierz pozycję C#: Uruchom projekt startowy. Inne sposoby uruchamiania programu w trybie debugowania to naciśnięcie F5 lub wybranie Uruchom>Rozpocznij debugowanie z menu.

   

3. Jeśli zostanie wyświetlony monit o wybierz pozycję Uruchom konfigurację, wybierz pozycję C#: HelloWorld HelloWorld.

4. Wybierz kartę konsoli debugowania , aby wyświetlić monit "Jaka jest Twoja nazwa?" wyświetlany przed oczekiwaniem na odpowiedź.

   

5. Wpisz ciąg w oknie konsoli debugowania w odpowiedzi na monit o nazwę, a następnie naciśnij Enter.

   Wykonanie programu zatrzymuje się po osiągnięciu punktu przerwania i przed uruchomieniem metody Console.WriteLine. W sekcji Locals okna Variables są wyświetlane wartości zmiennych zdefiniowanych w aktualnie uruchomionej metodzie.

   

Korzystanie z konsoli debugowania

Okno konsoli debugowania pozwala na interakcję z aplikacją, którą debugujesz. Możesz zmienić wartość zmiennych, aby zobaczyć, jak ma to wpływ na program.

1. Wybierz kartę konsoli debugowania .

2. Wprowadź w wierszu polecenia w dolnej części okna konsoli debugowania i naciśnij Enter.

   

3. Wprowadź currentDate = DateTime.Parse("2019-11-16T17:25:00Z").ToUniversalTime() w dolnej części okna Konsoli debugowania i naciśnij Enter.

   W oknie Zmienne wyświetlane są nowe wartości zmiennych name i currentDate.

4. Kontynuuj wykonywanie programu, wybierając przycisk Kontynuuj na pasku narzędzi. Innym sposobem kontynuowania jest naciśnięcie F5.

   

   Wartości wyświetlane w oknie konsoli odpowiadają zmianom wprowadzonych w konsoli debugowania .

   

5. Naciśnij wprowadź, aby zamknąć aplikację i zatrzymać debugowanie.

Ustawianie warunkowego punktu przerwania

Program wyświetla ciąg wprowadzony przez użytkownika. Co się stanie, jeśli użytkownik nic nie wprowadzi? Można to przetestować za pomocą przydatnej funkcji debugowania o nazwie warunkowego punktu przerwania.

1. Kliknij prawym przyciskiem myszy na czerwonej kropce (Ctrl-kliknij w systemie macOS), która reprezentuje punkt przerwania. W menu kontekstowym wybierz pozycję Edytuj punkt przerwania, aby otworzyć okno dialogowe umożliwiające wprowadzenie wyrażenia warunkowego.

   

2. Wybierz Expression na liście rozwijanej, wprowadź następujące wyrażenie warunkowe i naciśnij Wprowadź.

   String.IsNullOrEmpty(name)
   

   

   Za każdym razem, gdy punkt przerwania zostanie trafiony, debuger wywołuje metodę String.IsNullOrEmpty(name) i przerywa działanie w tym wierszu tylko wtedy, gdy wywołanie metody zwraca true.

   Zamiast wyrażenia warunkowego można określić liczbę trafień, która przerywa wykonywanie programu przed uruchomieniem instrukcji określoną liczbę razy. Inną opcją jest określenie warunku filtru , który przerywa wykonywanie programu na podstawie takich atrybutów jak identyfikator wątku, nazwa procesu lub nazwa wątku.

3. Uruchom program z debugowaniem, naciskając F5.

4. Na karcie Debug Console naciśnij Enter, gdy zostaniesz poproszony o podanie swojego imienia.

   Ponieważ określony warunek (name jest null lub String.Empty) został spełniony, wykonanie programu zatrzymuje się po osiągnięciu punktu przerwania i przed uruchomieniem metody Console.WriteLine.

   W oknie zmiennych widać, że wartość zmiennej jest lub .

5. Upewnij się, że wartość jest pustym ciągiem, wpisując następujące polecenie przy monicie konsoli debugowania i naciskając Enter. Wynik jest true.

   name == String.Empty
   

6. Wybierz przycisk Kontynuuj na pasku narzędzi, aby kontynuować wykonywanie programu.

7. Naciśnij wprowadź, aby zakończyć działanie programu i zatrzymać debugowanie.

8. Wyczyść punkt przerwania, klikając kropkę na lewym marginesie okna kodu. Inne sposoby czyszczenia punktu przerwania polegają na naciśnięciu F9 lub wybraniu Uruchom > Przełącz punkt przerwania z menu podczas wybierania wiersza kodu.

9. Jeśli zostanie wyświetlone ostrzeżenie, że warunek punktu przerwania zostanie utracony, wybierz pozycję Usuń punkt przerwania.

Przechodzenie przez program

Visual Studio Code umożliwia również przechodzenie przez program linia po linii i monitorowanie jego wykonania. Zazwyczaj należy ustawić punkt przerwania i śledzić przepływ programu przez niewielką część kodu programu. Ponieważ ten program jest mały, można przejść przez cały program.

1. Ustaw punkt przerwania na otwierającym nawiasie klamrowym metody Main.

2. Naciśnij F5, aby rozpocząć debugowanie.

   Program Visual Studio Code podświetla wiersz punktu przerwania.

   W tym momencie okno Zmiennych pokazuje, że tablica jest pusta, a i mają wartości domyślne.

3. Wybierz pozycję Uruchom>Przejdź do lub naciśnij F11.

   przycisk

   Program Visual Studio Code wyróżnia następny wiersz.

4. Wybierz pozycję Uruchom>Przejdź do lub naciśnij F11.

   Visual Studio Code uruchamia Console.WriteLine dla okna dialogowego nazwy i wyróżnia kolejny wiersz wykonywanego kodu. Następny wiersz to Console.ReadLine dla name. Okno zmiennych jest niezmienione, a karta Terminal wyświetla monit "Jak się nazywasz?".

5. Wybierz pozycję Uruchom>Przejdź do lub naciśnij F11.

   Program Visual Studio wyróżnia przypisanie zmiennej name. Okno Zmienne pokazuje, że name jest nadal null.

6. Odpowiedz na monit, wprowadzając ciąg na karcie Terminal i naciskając Enter.

   Karta konsoli debugowania może nie wyświetlać wprowadzonego ciągu, ale metoda przechwytuje dane wejściowe.

7. Wybierz pozycję Uruchom>Przejdź do lub naciśnij F11.

   Program Visual Studio Code wyróżnia przypisanie zmiennej currentDate. W oknie Zmienna jest wyświetlana wartość zwrócona przez wywołanie metody Console.ReadLine. Karta terminalu wyświetla ciąg wprowadzony w wierszu polecenia.

8. Wybierz pozycję Uruchom>Przejdź do lub naciśnij F11.

   W oknie Zmienne jest wyświetlana wartość zmiennej currentDate po przypisaniu wartości z właściwości DateTime.Now.

9. Wybierz pozycję Uruchom>Przejdź do lub naciśnij F11.

   Program Visual Studio Code wywołuje metodę Console.WriteLine(String, Object, Object). W oknie konsoli zostanie wyświetlony sformatowany ciąg.

10. Wybierz Uruchom>Wyloguj się lub naciśnij Shift+F11.

    przycisk

    W terminalu zostanie wyświetlony komunikat "Naciśnij dowolny klawisz, aby zakończyć..."

11. Naciśnij dowolny, aby zamknąć program.

Korzystanie z konfiguracji kompilacji wydania

Po przetestowaniu wersji Debug aplikacji należy również skompilować i przetestować wersję Release. Wersja wydania zawiera optymalizacje kompilatora, które mogą mieć wpływ na zachowanie aplikacji. Na przykład optymalizacje kompilatora, które mają poprawić wydajność, mogą tworzyć warunki wyścigowe w aplikacjach wielowątkowych.

Aby skompilować i przetestować wersję wydania aplikacji konsolowej, otwórz Terminal i uruchom następujące polecenie:

dotnet run --configuration Release

Dodatkowe zasoby

• Debugowanie w programie Visual Studio Code

Następne kroki

W tym samouczku użyto narzędzi debugowania programu Visual Studio Code. W następnym samouczku opublikujesz wersję aplikacji nadającą się do wdrożenia.

Publikowanie aplikacji konsolowej .NET przy użyciu programu Visual Studio Code