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

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

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

Aby uzyskać więcej informacji, zobacz Konfiguracje debugowania i wydania.

Ważny

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

Karta debugowania

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

Profil uruchomieniowy (.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 Uruchom program zewnętrzny.
katalog roboczy	Określa katalog roboczy debugowanej aplikacji. W języku C#katalog roboczy jest domyślnie \bin\debug.
Korzystanie z maszyny zdalnej	W przypadku zdalnego debugowania wybierz tę opcję i wprowadź nazwę obiektu docelowego debugowania zdalnego lub nazwa serwera Msvsmon. Położenie aplikacji na maszynie zdalnej jest określane przez właściwość Output Path na karcie Kompilacja. Położenie musi być katalogiem współdzielonym na maszynie zdalnej.
zmienne środowiskowe	Ustawia zmienne środowiskowe przed uruchomieniem procesu aplikacji. Dla ASP.NET Core, zobacz Environments.
Włącz debugowanie kodów 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łącz debugowanie elementu WebView2	Debuguje kod JavaScript przy użyciu debugera opartego na przeglądarce Microsoft Edge (Chromium).

Profil uruchomienia (ASP.NET Core)

Oprócz właściwości dostępnych w platformie .NET 5+, profile uruchamiania ASP.NET Core zawierają kilka dodatkowych właściwości dla różnych profilów ASP.NET Core. Te ustawienia zapewniają prosty interfejs użytkownika dla pliku launchSettings.json projektu. Aby uzyskać więcej informacji na temat tego pliku, zobacz sekcję Rozwój i launchSettings.json w Używanie wielu środowisk w ASP.NET Core.

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

Ustawienie	Opis
Uruchom przeglądarkę	Wybierz, czy podczas uruchamiania debugowania ma być uruchamiana domyślna przeglądarka, korzystając z adresu URL, który ustawiłeś w ustawieniu adresu URL.
adres URL	Określa lokalizację adresu URL hosta dla platformy .NET lub .NET Core. W przypadku profilu nazwanego po projekcie (to znaczy, że właściwość commandName w launchSettings.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 Konfigurowanie projektu.
adres URL aplikacji	Określa adresy URL aplikacji. W przypadku profilu o nazwie po projekcie ta właściwość określa adresy URL serwera Kestrel, zazwyczaj https://localhost:5001 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ż ustawieniaom w launchSettings.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 Modele hostingu w dokumentacji platformy ASP.NET Core.
adres URL protokołu SSL aplikacji	Dla IIS Express, adres URL protokołu SSL aplikacji jest zazwyczaj http://localhost:44334.

Karta Budowanie

W poniższej tabeli przedstawiono ustawienia kompilacji, które są przydatne do debugowania. Aby uzyskać pełne wyjaśnienie ustawień kompilacji, zobacz zakładkę Kompilacja w Projektancie projektu.

Ustawienie	Opis
ogólne symbole kompilacji warunkowej>	Zdefiniuj stałe DEBUG i TRACE, jeśli wybrano. Te stałe umożliwiają warunkową kompilację klasy debugowania i trace klasy. Po zdefiniowaniu tych stałych metody klas Debug i Trace generują dane wyjściowe do okna Output . 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 Debug, jak i Release.
Ogólne>Optymalizowanie kodu	Jeśli usterka pojawia się tylko w zoptymalizowanym kodzie, zostaw to ustawienie odznaczone dla kompilacji debug. 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 Symbole debugowania. Aby uzyskać informacje na temat konfigurowania wydajności debugowania aplikacji, zobacz Ułatwianie debugowaniaobrazu.
Wyjście>Podstawowa ścieżka wyjściowa	Określa folder podstawowy dla danych wyjściowych pośrednich. Dane wyjściowe zazwyczaj są kierowane do bin\Debug dla kompilacji Debug.
wyjście>bazowa pośrednia ścieżka wyjściowa	Określa folder podstawowy dla danych wyjściowych pośrednich. Dane wyjściowe zazwyczaj są obj\Debug kompilacji debugowania.

Symbole debugowania

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

• Żadne symbole nie są emitowane

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

• plik PDB, bieżąca platforma

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

• plik PDB, przenośny

  Tworzy plik .PDB, niezależny od platformy, przenośny plik symboli, który udostępnia innym narzędziom, szczególnie debugerom, informacje o tym, co znajduje się w głównym pliku wykonywalnym i o sposobie jego utworzenia. Aby uzyskać więcej informacji, zobacz Portable PDB.

• Wbudowane w biblioteki DLL/EXE, przenośne na różnych platformach

  Osadza przenośne informacje o symbolach w zestawie. Nie tworzony jest zewnętrzny plik .PDB.

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

Zobacz też

• ustawienia debugera i przygotowanie