Sdílet prostřednictvím

Nastavení projektu pro konfigurace ladění jazyka C# (.NET Core, .NET 5 nebo novější a ASP.NET Core)

Nastavení ladění projektu jazyka C# můžete změnit na stránkách vlastností projektu na kartách Ladění a Sestavení.

Chcete-li otevřít stránky vlastností, vyberte projekt v průzkumníku řešení a pak vyberte ikonu Vlastnosti nebo klikněte pravým tlačítkem myši na projekt a vyberte Vlastnosti.

Další informace najdete v tématu Konfigurace ladění a vydávání verzí.

Důležitý

Tato nastavení se nevztahují na aplikace .NET Framework nebo UPW. Informace o konfiguraci nastavení ladění pro rozhraní .NET Framework najdete v tématu Nastavení projektu pro konfigurace ladění jazyka C#.

Karta Ladění

Počínaje sadou Visual Studio 2022 zvolte Otevřít uživatelské rozhraní spouštěcích profilů ladění na kartě Ladění, abyste otevřeli uživatelské rozhraní profilů spuštění a změnili nastavení ladění.

Profil spuštění (.NET Core, .NET 5+)

Nastavení Popis
argumenty příkazového řádku Určuje argumenty příkazového řádku pro laděnou aplikaci. Název příkazu je název aplikace zadaný v Spustit externí program.
pracovní adresář Určuje pracovní adresář laděné aplikace. V jazyce C# je pracovní adresář ve výchozím nastavení \bin\debug.
Použití vzdáleného počítače Pro vzdálené ladění vyberte tuto možnost a zadejte název cíle vzdáleného ladění nebo název serveru Msvsmon.
Umístění aplikace na vzdáleném počítači je určeno vlastností Výstupní cesta na kartě Sestavení. Umístění musí být na vzdáleném počítači sdíleným adresářem.
proměnné prostředí Nastaví proměnné prostředí před spuštěním procesu aplikace. Podívejte se na prostředí ASP.NET Core .
Povolení nespravovaného ladění kódu Ladí volání nativního (nespravovaného) kódu Win32 ze spravované aplikace.
Povolení ladění SQL Serveru Ladí databázové objekty SQL Serveru.
Povolit ladění WebView2 Ladí JavaScript pomocí ladicího programu založeného na Prohlížeči Microsoft Edge (Chromium).

Spouštěcí profil (ASP.NET Core)

Kromě vlastností pro .NET 5+ zahrnují spouštěcí profily ASP.NET Core několik dalších vlastností pro různé profily ASP.NET Core. Tato nastavení poskytují jednoduché uživatelské rozhraní pro soubor launchSettings.json projektu. Další informace o tomto souboru naleznete v části Vývoj a launchSettings.json v Použití více prostředí v ASP.NET Core.

Nastavení uvedená v uživatelském rozhraní profilů spuštění zahrnují následující.

Nastavení Popis
Spustit prohlížeč Vyberte, jestli se má při spuštění ladění spustit výchozí prohlížeč pomocí adresy URL, kterou jste nastavili v nastavení url.
URL Určuje umístění adresy URL hostitele pro .NET nebo .NET Core. Pro profil pojmenovaný po projektu (tj. vlastnost commandName v launchSettings.json je Project), server Kestrel naslouchá zadanému portu. U profilu služby IIS je to obvykle stejná hodnota jako adresa URL aplikace . Další informace naleznete v části spouštěcí profil služby IIS v části Konfigurace projektu.
URL aplikace Určuje adresy URL aplikace. Pro profil pojmenovaný po projektu tato vlastnost určuje adresy URL serveru Kestrel, obvykle https://localhost:5001 a http://localhost:5000.

Visual Studio ve výchozím nastavení poskytuje profil SLUŽBY IIS Express a můžete vytvořit další profily, jako je profil služby IIS. Tato nastavení také odpovídají nastavením v launchSettings.json. Tyto dva typy profilů poskytují několik nastavení, například model hostování.

Nastavení Popis
model hostování Určete stav V procesu (výchozí) nebo Mimo proces. Další informace najdete v tématu Hostování modelů v dokumentaci ASP.NET Core.
adresa URL SSL aplikace V případě služby IIS Express je adresa URL SSL aplikace obvykle http://localhost:44334.

Karta Sestavení

Následující tabulka ukazuje nastavení sestavení, která jsou užitečná pro ladění. Úplné vysvětlení nastavení sestavení najdete v tématu Stránka sestavení, Návrhář projektu.

Nastavení Popis
Obecné>Symboly podmíněné kompilace Definujte konstanty DEBUG a TRACE, pokud jsou vybrány.

Tyto konstanty umožňují podmíněnou kompilaci třídy Debug a trace třídy. S použitím těchto konstant metody třídy Debug a Trace generují výstup do okna . Bez těchto konstant nejsou kompilovány metody třídy Debug a Trace a nevygeneruje se žádný výstup.

Obvykle je DEBUG definován v ladicí verzi sestavení a není definován ve verzi vydání. TRACE je definováno ve verzích Debug i Release.
Obecné>Optimalizovat kód Pokud se chyba objeví pouze v optimalizovaném kódu, ponechte toto nastavení nezvolené pro ladicí sestavení. Optimalizovaný kód je obtížnější ladit, protože instrukce neodpovídají přímo příkazům ve zdrojovém kódu.
symboly ladění Určuje typ informací o ladění generovaných kompilátorem. Viz Symboly ladění. Informace o tom, jak nakonfigurovat výkon ladění aplikace, naleznete v tématu Usnadnění ladění obrázku.
výstupní>základní výstupní cesta Určuje základní složku pro zprostředkující výstup. Výstup obvykle přejde do bin\Debug pro Debug sestavení.
výstupní cesta>základní zprostředkující výstupní cesta Určuje základní složku pro zprostředkující výstup. Výstup obvykle přejde do obj\Debug pro ladicí sestavení.

Symboly ladění

Pro symboly ladění můžete zvolit následující možnosti.

  • nejsou generovány žádné symboly

    Udává, že žádné informace o ladění nebudou generovány.

  • PDB soubor, aktuální platforma

    Vytvoří . PDB soubor, soubor symbolu specifický pro platformu, který poskytuje další nástroje, zejména ladicí programy, informace o tom, co je v hlavním spustitelném souboru a jak byl vytvořen.

  • PDB soubor, přenosný

    Vytvoří .PDB soubor, nezávislý na platformě, přenosný symbolický soubor, který poskytuje dalším nástrojům, zejména ladicím programům, informace o tom, co je v hlavním spustitelném souboru a jak byl vytvořen. Další informace viz Portable PDB.

  • Vloženo v rámci knihovny DLL/EXE, přenosné mezi různými platformami

    Vloží do sestavení přenosné informace o symbolech. Nevytváří se žádný vnější soubor PDB.

Další informace najdete v tématu /debug (možnosti kompilátoru jazyka C#).

Viz také