Ustawienia projektu dla konfiguracji debugowania języka C# (.NET Core, .NET 5+i ASP.NET Core)

  • Artykuł

Ustawienia debugowania projektu języka C# można zmienić na karcie Debugowanie i karcie Kompilacja stron właściwości projektu.

Aby otworzyć strony właściwości, wybierz projekt w Eksplorator rozwiązań, a następnie wybierz ikonę Właściwości lub kliknij prawym przyciskiem myszy projekt i wybierz polecenie Właściwości.

Aby uzyskać więcej informacji, zobacz Debugowanie i konfiguracje wersji.

Ważne

Te ustawienia nie mają zastosowania do aplikacji platformy .NET Framework ani platformy UWP. Aby skonfigurować ustawienia debugowania dla programu .NET Framework, zobacz Project settings for C# debug configurations (Ustawienia projektu dla konfiguracji debugowania języka C#).

Karta Debugowanie

Począwszy od programu Visual Studio 2022, wybierz pozycję Otwórz interfejs użytkownika profilów uruchamiania debugowania na karcie Debugowanie, aby otworzyć interfejs użytkownika profilów uruchamiania i zmienić ustawienia debugowania.

Uruchamianie profilu (.NET Core, .NET 5+)

Ustawienie opis
Argumenty wiersza polecenia Określa argumenty wiersza polecenia dla debugowanej aplikacji. Nazwa polecenia to nazwa aplikacji określona w obszarze Uruchom program zewnętrzny.
Katalog roboczy Określa katalog roboczy debugowanej aplikacji. W języku C#katalog roboczy to \bin\debug domyślnie.
Korzystanie z maszyny zdalnej W przypadku zdalnego debugowania wybierz tę opcję i wprowadź nazwę docelowego zdalnego debugowania lub nazwę serwera Msvsmon.
Lokalizacja aplikacji na maszynie zdalnej jest określana przez właściwość Ścieżka wyjściowa na karcie Kompilacja . Lokalizacja musi być katalogiem z możliwością udostępniania na maszynie zdalnej.
Zmienne środowiskowe Ustawia zmienne środowiskowe przed uruchomieniem procesu aplikacji. Aby uzyskać ASP.NET Core, zobacz Środowiska.
Włączanie debugowania kodu niezarządzanych Debuguje wywołania do natywnego (niezarządzanego) kodu Win32 z aplikacji zarządzanej.
Włączanie debugowania programu SQL Server Debuguje obiekty bazy danych programu SQL Server.
Włączanie debugowania webview2 Debuguje kod JavaScript przy użyciu debugera opartego na przeglądarce Microsoft Edge (Chromium).

Uruchamianie profilu (ASP.NET Core)

Oprócz właściwości platformy .NET 5 lub nowszej ASP.NET Core profile uruchamiania zawierają kilka dodatkowych właściwości dla różnych profilów ASP.NET Core. Te ustawienia zapewniają prosty interfejs użytkownika dla pliku launch projektu Ustawienia.json. Aby uzyskać więcej informacji na temat tego pliku, zobacz sekcję Programowanie i uruchamianie Ustawienia.json w temacie Używanie wielu środowisk w programie ASP.NET Core.

Ustawienia podane w interfejsie użytkownika profilów uruchamiania obejmują następujące ustawienia.

Ustawienie opis
Uruchamianie przeglądarki Wybierz, czy chcesz uruchomić domyślną przeglądarkę podczas uruchamiania debugowania, używając adresu URL ustawionego w ustawieniu Adres URL .
Adres url Określa lokalizację adresu URL hosta dla platformy .NET lub .NET Core. W przypadku profilu o nazwie po projekcie (czyli właściwości commandName w pliku launch Ustawienia.json to Project), serwer Kestrel nasłuchuje określonego portu. W przypadku profilu usług IIS jest to zazwyczaj ta sama wartość co adres URL aplikacji. Aby uzyskać więcej informacji, zobacz sekcję Profil uruchamiania usług IIS w sekcji Konfigurowanie projektu.
Adres URL aplikacji Określa adresy URL aplikacji. W przypadku profilu o nazwie po projekcie https://localhost:5001 ta właściwość określa adresy URL serwera Kestrel, zazwyczaj i http://localhost:5000

Program Visual Studio domyślnie udostępnia profil usług IIS Express i można tworzyć dodatkowe profile, takie jak profil usług IIS. Te ustawienia odpowiadają również ustawień w pliku launch Ustawienia.json. Te dwa typy profilów udostępniają kilka ustawień, takich jak model hostingu.

Ustawienie opis
Model hostingu Określ wartość W procesie (wartość domyślna) lub Poza procesem. Aby uzyskać więcej informacji, zobacz Hostowanie modeli w dokumentacji platformy ASP.NET Core.
Adres URL protokołu SSL aplikacji W przypadku usług IIS Express adres URL protokołu SSL aplikacji jest zazwyczaj http://localhost:44334.

Karta Kompilacja

W poniższej tabeli przedstawiono ustawienia kompilacji, które są przydatne do debugowania. Aby uzyskać pełne wyjaśnienie ustawień kompilacji, zobacz Strona kompilacji, Projekt Projektant.

Ustawienie opis
Ogólne>symbole kompilacji warunkowej Zdefiniuj stałe DEBUG i TRACE, jeśli wybrano.

Te stałe umożliwiają warunkową kompilację klasy Debug i klasy Trace. Po zdefiniowaniu tych stałych metody klasy Debug i Trace generują dane wyjściowe w oknie Dane wyjściowe. Bez tych stałych metody klasy Debug i Trace nie są kompilowane i nie są generowane żadne dane wyjściowe.

Zwykle debugowanie jest definiowane w wersji debugowania kompilacji i niezdefiniowane w wersji wydania. Funkcja TRACE jest definiowana zarówno w wersjach debugowania, jak i wydania.
Ogólny>kod optymalizacji Jeśli nie zostanie wyświetlona usterka tylko w zoptymalizowanym kodzie, pozostaw to ustawienie usunięte dla kompilacji debugowania. Zoptymalizowany kod jest trudniejszy do debugowania, ponieważ instrukcje nie odpowiadają bezpośrednio instrukcjom w kodzie źródłowym.
Symbole debugowania Określa typ informacji debugowania generowanych przez kompilator. Zobacz Debugowanie symboli. Aby uzyskać informacje na temat konfigurowania wydajności debugowania aplikacji, zobacz Tworzenie obrazu łatwiejszego do debugowania.
Ścieżka wyjściowa>bazy danych wyjściowych Określa folder podstawowy dla danych wyjściowych pośrednich. Dane wyjściowe zazwyczaj przechodzą do bin\Debug dla kompilacji debugowania .
Ścieżka danych wyjściowych>bazowego pośredniego Określa folder podstawowy dla danych wyjściowych pośrednich. Dane wyjściowe zazwyczaj przechodzą do obj\Debug dla kompilacji debugowania .

Symbole debugowania

Możesz wybrać następujące opcje dla symboli debugowania.

  • Nie są emitowane żadne symbole

    Określa, że żadne informacje debugowania nie zostaną wygenerowane.

  • Plik PDB, bieżąca platforma

    Tworzy element . Plik PDB, plik symboli specyficzny dla platformy, który udostępnia inne narzędzia, zwłaszcza debugery, informacje o tym, co znajduje się w głównym pliku wykonywalnym i jak został utworzony.

  • Plik PDB, przenośny

    Tworzy element . Plik PDB, nieoparty na platformie, przenośny plik symboli, który udostępnia inne narzędzia, zwłaszcza debugery, informacje o tym, co znajduje się w głównym pliku wykonywalnym i sposobie jego tworzenia. Aby uzyskać więcej informacji, zobacz Przenośny plik PDB .

  • Osadzone w pliku DLL/EXE, przenośne na różnych platformach

    Osadza przenośne informacje o symbolach w zestawie. Brak zewnętrznego . Tworzony jest plik PDB.

Aby uzyskać więcej informacji, zobacz /debug (Opcje kompilatora C#).

Zobacz też