Vzdálené ladění projektu C# nebo Visual Basic ve Visual Studiu

Pokud chcete ladit Visual Studio aplikaci nasazenou na jiném počítači, nainstalujte a spusťte vzdálené nástroje na počítači, na kterém jste aplikaci nasadili, nakonfigurujte project pro připojení ke vzdálenému počítači z Visual Studio a pak spusťte aplikaci.

snímek obrazovky s komponentami vzdáleného ladicího programuRemote_debugger_components

Informace o vzdáleném ladění univerzálních aplikací pro Windows (UPW) najdete v tématu Ladění nainstalovaného balíčku aplikace.

Požadavky

Vzdálený ladicí program je podporován v systémech Windows 7 a novějších a ve verzích Windows Server od verze Windows Server 2008 Service Pack 2. Úplný seznam požadavků najdete v tématu Požadavky.

Poznámka

Ladění mezi dvěma počítači připojenými přes proxy server se nepodporuje. Ladění přes připojení s vysokou latencí nebo nízkou šířkou pásma, jako je například vytáčené připojení k internetu, nebo přes internet mezi různými zeměmi nebo oblastmi, se nedoporučuje a může selhat nebo být nepřijatelně pomalé.

Stažení a instalace vzdálených nástrojů

Na vzdáleném zařízení nebo serveru, na které chcete ladit, místo Visual Studio počítače stáhněte a nainstalujte správnou verzi vzdálených nástrojů z odkazů v následující tabulce.

• Stáhněte si nejnovější aktualizaci vzdálených nástrojů pro vaši verzi Visual Studio. Vzdálené nástroje pro Visual Studio 2022 a 2026 je možné použít s některou verzí Visual Studio. Verze vzdálených nástrojů starší než Visual Studio 2022 ale nejsou kompatibilní s novějšími verzemi Visual Studio. (Pokud například používáte Visual Studio 2019, stáhněte si nejnovější aktualizaci vzdálených nástrojů pro Visual Studio 2019. V tomto scénáři nestahujte vzdálené nástroje pro Visual Studio 2022.)

• Stáhněte si vzdálené nástroje se stejnou architekturou jako počítač, na který je instalujete. Pokud například chcete ladit aplikace x86 na vzdáleném počítači s operačním systémem x64, nainstalujte vzdálené nástroje x64. Pokud chcete ladit aplikace x86, ARM nebo x64 v operačním systému ARM64, nainstalujte vzdálené nástroje ARM64.

Verze	Odkaz	Poznámky
Visual Studio 2026	Vzdálené nástroje	Kompatibilní s Visual Studio 2022 a novějšími verzemi. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Na starších verzích Windows Serveru viz Odblokování stahování souboru pokyny pro stažení vzdálených nástrojů.
Visual Studio 2022	Vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2022 jsou k dispozici v My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Na starších verzích Windows Serveru viz Odblokování stahování souboru pokyny pro stažení vzdálených nástrojů.
Visual Studio 2019	Vzdálené nástroje	Dálkové nástroje pro Visual Studio 2019 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Na starších verzích Windows Serveru viz Odblokování stahování souboru pokyny pro stažení vzdálených nástrojů.
Visual Studio 2017	Vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2017 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Na Windows Serveru se podívejte na Odblokování stahování souboru, kde naleznete nápovědu ke stažení vzdálených nástrojů.
Visual Studio 2015	Vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2015 jsou k dispozici v My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Na Windows Serveru se podívejte na Odblokování stahování souboru, kde naleznete nápovědu ke stažení vzdálených nástrojů.
Visual Studio 2013	Vzdálené nástroje	Stránka ke stažení v dokumentaci k Visual Studio 2013
Visual Studio 2012	Vzdálené nástroje	Stránka ke stažení v dokumentaci k Visual Studio 2012

Vzdálený ladicí program můžete spustit zkopírováním msvsmon.exe do vzdáleného počítače, nikoli instalací vzdálených nástrojů. Průvodce konfigurací vzdáleného ladicího programu (rdbgwiz.exe) je však k dispozici pouze při instalaci vzdálených nástrojů. Pokud chcete spustit vzdálený ladicí program jako službu, možná budete muset použít průvodce pro konfiguraci. Další informace naleznete v tématu (volitelné) Konfigurace vzdáleného ladicího programu jako služby.

Poznámka

• K ladění Windows 10 nebo novějších aplikací na zařízeních ARM použijte ARM64, který je k dispozici s nejnovější verzí vzdálených nástrojů.
• Pokud chcete ladit Windows 10 aplikace na zařízeních Windows RT, použijte ARM, který je k dispozici pouze ve stažení vzdálených nástrojů Visual Studio 2015.
• Pokud chcete ladit aplikace x64 v operačním systému ARM64, spusťte msvsmon.exe x64 nainstalované se vzdálenými nástroji ARM64.

Spropitné

V některých scénářích může být nejúčinnější spustit vzdálený ladicí program ze sdílené složky. Další informace naleznete v tématu Spuštění vzdáleného ladicího programu ze sdílené složky.

Nastavení vzdáleného ladicího programu

Po instalaci vzdáleného ladicího programu postupujte podle těchto kroků.

1. Na vzdáleném počítači vyhledejte a spusťte vzdálený ladicí program z nabídky Start.

   Pokud nemáte oprávnění správce na vzdáleném počítači, klikněte pravým tlačítkem myši na aplikaci vzdáleného ladicího programu a vyberte Spustit jako správce. V opačném případě ho jednoduše zahajte normálně.

   Pokud se chystáte připojit k procesu, který běží jako správce nebo běží pod jiným uživatelským účtem (například IIS), klikněte pravým tlačítkem na aplikaci Remote Debugger a vyberte Spustit jako správce. Další informace naleznete v části Spuštění vzdáleného ladicího programu jako správce.

2. Při prvním spuštění vzdáleného ladicího programu (nebo před jeho nakonfigurováním) se zobrazí konfigurační průvodce konfigurace vzdáleného ladicího programu.

   Ve většině scénářů zvolte Konfigurovat vzdálené ladění.

   snímek obrazovky s konfigurací vzdáleného ladicího programu.Konfigurace vzdáleného ladicího programu

3. Vyberte aspoň jeden typ sítě, na který chcete používat vzdálené nástroje. Pokud jsou počítače připojené přes doménu, musíte zvolit první položku. Pokud jsou počítače připojené přes pracovní skupinu nebo domácí skupinu, podle potřeby zvolte druhou nebo třetí položku.

   Potom vyberte Dokončit a spusťte vzdálený ladicí program.

4. Po dokončení konfigurace se zobrazí okno Remote Debugger.

   snímek obrazovky okna vzdáleného ladicího programuokno vzdáleného ladicího programu

   Vzdálený ladicí program teď čeká na připojení. K nastavení konfigurace vzdáleného připojení v Visual Studio použijte název serveru a číslo portu.

Pokud chcete vzdálený ladicí program zastavit, vyberte SouborUkončit. Můžete ho restartovat z nabídky Start nebo z příkazového řádku:

<Remote debugger installation directory>\msvsmon.exe

Poznámka

Pokud potřebujete přidat oprávnění pro další uživatele, změnit režim ověřování nebo číslo portu vzdáleného ladicího programu, přečtěte si téma Konfigurace vzdáleného ladicího programu.

Ladit projekt na dálku

Ladicí program nemůže nasadit desktopové aplikace Visual C# nebo Visual Basic na vzdálený počítač, ale můžete je stále vzdáleně ladit, a to následujícím způsobem. Následující postup předpokládá, že ho chcete ladit na počítači s názvem MJO-DL, jak je znázorněno na obrázku níže.

1. Vytvořte WPF project s názvem MyWpf.

   Pokud se místo WPF pokoušíte vzdáleně ladit aplikaci MAUI, přečtěte si téma Remote ladění aplikace .NET MAUI ve Windows.

2. Nastavte zarážku někde v kódu, který je snadno dosažitelný.

   Například můžete nastavit zarážku v obslužné rutině tlačítka. Pro provedení tohoto otevřete soubor MainWindow.xaml a z panelu nástrojů přidejte ovládací prvek Button. Poté poklepáním na tlačítko otevřete jeho obslužnou rutinu.

3. V Solution Explorer klikněte pravým tlačítkem na project a zvolte Properties.

4. Na stránce Vlastnosti zvolte kartu Ladění.

   U projektů C#, které cílí na .NET Core nebo .NET 5 a novější, počínaje ve Visual Studio 2022 zvolte uživatelské rozhraní profilů spuštění pro ladění na kartě Debug a nakonfigurujte nastavení pro vzdálené ladění.

   

   Jinak pro .NET Framework změníte nastavení vzdáleného ladění přímo na kartě Debug.

   

5. Ujistěte se, že je textové pole Pracovní adresář prázdné.

6. Zvolte Použítvzdálený počítač a zadejte do textového pole název_počítače:port. Číslo portu se zobrazí v okně vzdáleného ladicího programu.

   V tomto příkladu použijte:

   MJO-DL:4026 Visual Studio 2022 nebo novější

7. Ujistěte se, že není zaškrtnuté políčko Povolit ladění nativního kódu .

8. Sestavte projekt.

9. Ve vzdáleném počítači vytvořte složku, která je stejná jako složka Debug ve vašem počítači Visual Studio: <source path>\MyWPF\MyWPF\bin\Debug.

10. Zkopírujte spustitelný soubor, který jste právě vytvořili ze svého počítače Visual Studio, do nově vytvořené složky na vzdáleném počítači.

    Opatrnost

    Neprovádejte změny kódu nebo opětovného sestavení (nebo tento krok musíte zopakovat). Spustitelný soubor, který jste zkopírovali do vzdáleného počítače, musí přesně odpovídat místnímu zdroji a symbolům.

    Project můžete zkopírovat ručně, použít XCopy, Robocopy, PowerShell nebo jiné možnosti.

11. Ujistěte se, že je vzdálený ladicí program spuštěný na cílovém počítači (Pokud ne, vyhledejte vzdálený ladicí program v nabídce Start). Okno vzdáleného ladicího programu vypadá takto.

    

12. V Visual Studio spusťte ladění (Debug > Spustit ladění nebo F5).

13. Pokud se zobrazí výzva, zadejte síťové přihlašovací údaje pro připojení ke vzdálenému počítači.

    Požadované přihlašovací údaje se liší v závislosti na konfiguraci zabezpečení vaší sítě. Například na počítači domény můžete zadat název domény a heslo. Na počítači mimo doménu můžete zadat název počítače a platný název uživatelského účtu, například MJO-DL\a správné heslo.

    Měli byste vidět, že hlavní okno aplikace WPF je otevřené na vzdáleném počítači.

14. V případě potřeby podnikněte kroky k dosažení záchytného bodu. Měli byste vidět, že zarážka je aktivní. Pokud tomu tak není, symboly aplikace se nenačetly. Zkuste to znovu a pokud to nepomůže, získejte informace o načítání symbolů a jejich řešení v Nastavení souborů symbolů a nastavení symbolů Visual Studio.

15. Na počítači s Visual Studiem byste měli vidět, že se spuštění zastavilo na bodu přerušení.

    Pokud máte nějaké jiné než kódové soubory, které musí aplikace používat, musíte je zahrnout do Visual Studio project. Vytvořte složku project pro další soubory (v Solution Explorer klikněte na Přidat > Nová složka). Potom přidejte soubory do složky (v Solution Explorer klikněte na Přidat > Existující položka a vyberte soubory). Na stránce Vlastnosti pro každý soubor nastavte Kopírovat do výstupního adresáře na Kopírovat vždy.

Vzdálené ladění aplikace .NET MAUI ve Windows

.NET aplikace MAUI jsou zabalené aplikace, které je potřeba zaregistrovat při nasazení, a ne jen zkopírovat do vzdáleného počítače. Pro vzdálené ladění můžete nasadit rozbalenou verzi aplikace.

Ke vzdálenému ladění použijte jednu z následujících metod:

• Publikujte aplikaci na vzdálené zařízení jako rozbalenou aplikaci pomocí kroků popsaných v Použít rozhraní příkazového řádku k publikování rozbalených aplikací .NET MAUI pro Windows a pak postupujte podle kroků v tomto článku pro vzdálené ladění. (Přeskočte kroky ke zkopírování aplikace.)

• Postupujte podle kroků v tomto článku, včetně kroků pro vytvoření profilu spuštění pro ladění konkrétního projektu. Před zahájením ladění ručně upravte soubor launchSettings.json a nahraďte hodnotu commandNameProject hodnotou MsixPackage, jak je znázorněno zde.

  "Remote Profile": {
    "commandName": "MsixPackage",
    "remoteDebugEnabled": true,
    "remoteDebugMachine": "170.200.20.22",
    "authenticationMode": "None"
  }
  

  Při spuštění ladění tato metoda nejprve nasadí rozbalenou verzi aplikace a spustí ji.

  Poznámka

  Jakmile změníte hodnotu na , nemůžete upravit v dialogu profilu spuštění ladění.

Nastavení ladění pomocí vzdálených symbolů

Kód byste měli být schopni ladit pomocí symbolů, které vygenerujete v počítači Visual Studio. Výkon vzdáleného ladicího programu je mnohem lepší, když používáte místní symboly. Pokud musíte použít vzdálené symboly, je potřeba informovat monitor ladění na dálku, aby tyto symboly hledal na vzdáleném počítači.

K použití vzdálených symbolů pro spravovaný kód můžete použít následující přepínač příkazového řádku msvsmon:

Další informace naleznete v nápovědě pro vzdálené ladění (stiskněte F1 v okně vzdáleného ladicího programu nebo klikněte na tlačítko Nápověda Využití).

Související obsah

• ladění v Visual Studio
• První pohled na ladicí program
• Konfigurace brány Windows Firewall pro vzdálené ladění
• Přiřazení Portů Vzdáleného Debuggeru
• Vzdálené ladění ASP.NET na vzdáleném počítači s IIS
• Chyby vzdáleného ladění a řešení potíží