Vzdálené ladění projektu jazyka C# nebo Visual Basic v sadě Visual Studio

Pokud chcete ladit aplikaci sady Visual Studio 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 projekt tak, aby se připojil ke vzdálenému počítači ze sady Visual Studio, a pak aplikaci spusťte.

Informace o vzdáleném ladění univerzálních aplikací pro Windows (UPW) naleznete 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 Systému Windows Server počínaje aktualizací 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 malou šířkou pásma, jako je například vytáčení internetu nebo přes internet v různých zemích nebo oblastech, se nedoporučuje a může selhat nebo může být nepřijatelné.

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

Na vzdáleném zařízení nebo serveru, na který chcete ladit, a ne na počítači se sadou Visual Studio, 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 sady Visual Studio. Starší verze vzdálených nástrojů nejsou kompatibilní s novějšími verzemi sady 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	Notes
Visual Studio 2022	Vzdálené nástroje	Kompatibilní se všemi verzemi sady Visual Studio 2022. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 nebo ARM64). Ve starších verzích Windows Serveru si přečtěte téma Odblokování stahování souboru, kde získáte pomoc se stažením vzdálených nástrojů.
Visual Studio 2019	Vzdálené nástroje	Kompatibilní se všemi verzemi sady Visual Studio 2019. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 nebo ARM64). Ve starších verzích Windows Serveru si přečtěte téma Odblokování stahování souboru, kde získáte pomoc se stažením vzdálených nástrojů.
Visual Studio 2017	Vzdálené nástroje	Kompatibilní se všemi verzemi sady Visual Studio 2017. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 nebo ARM64). Na Windows Serveru si přečtěte článek Odblokování stahování souborů, kde získáte 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í ID předplatného sady Visual Studio. Na Windows Serveru si přečtěte článek Odblokování stahování souborů, kde získáte 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 sadě Visual Studio 2013
Visual Studio 2012	Vzdálené nástroje	Stránka ke stažení v dokumentaci k sadě Visual Studio 2012

Vzdálený ladicí program můžete spustit zkopírováním msvsmon.exe do vzdáleného počítače místo instalace 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 najdete v tématu (Volitelné) Konfigurace vzdáleného ladicího programu jako služby.

Poznámka:

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

Tip

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

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 na aplikaci Vzdálený ladicí program 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 Vzdáleného ladicího programu a vyberte Spustit jako správce. Další informace naleznete v tématu 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 konfigurací) se zobrazí průvodce konfigurací vzdáleného ladění.

   Ve většině scénářů zvolte Další , dokud se nedostanete na stránku Konfigurovat bránu Windows Firewall v průvodci.

   

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 vzdáleného ladicího programu .

   

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

Pokud chcete vzdálený ladicí program zastavit, vyberte Ukončit soubor>. 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ěňte 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.

Vzdálené ladění projektu

Ladicí program nemůže nasadit desktopové aplikace Visual C# nebo Visual Basic do vzdáleného počítače, ale přesto je můžete vzdáleně ladit 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 následujícím obrázku.

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

   Pokud se pokoušíte vzdáleně ladit aplikaci MAUI místo WPF, přečtěte si téma Vzdálené 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. Uděláte to tak, že otevřete MainWindow.xaml a přidáte z panelu nástrojů ovládací prvek Tlačítko a poklikáním na tlačítko otevřete jeho obslužnou rutinu.

3. V Průzkumník řešení klikněte pravým tlačítkem myši na projekt a zvolte Vlastnosti.

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

   V případě projektů C# určených pro .NET Core nebo .NET 5 nebo novější v sadě Visual Studio 2022 zvolte uživatelské rozhraní profilů spuštění ladění na kartě Ladění a nakonfigurujte nastavení pro vzdálené ladění.

   

   Jinak změníte nastavení vzdáleného ladění přímo na kartě Ladění .

   

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

6. Zvolte Použít vzdálený počítač a do textového pole zadejte yourmachinename:port . (Číslo portu se zobrazí v okně vzdáleného ladicího programu. Číslo portu se zvýší 2 v každé verzi sady Visual Studio).

   V tomto příkladu použijte:

   MJO-DL:4026 v sadě Visual Studio 2022

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

8. Sestavte projekt.

9. Na vzdáleném počítači vytvořte složku, která je stejná jako složka Debug na počítači sady Visual Studio: <zdrojová cesta>\MyWPF\MyWPF\bin\Debug.

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

    Upozornění

    Neprovádejte změny kódu nebo opětovného sestavení (nebo tento krok musíte opakovat). 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.

    Projekt 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 sadě Visual Studio spusťte ladění (ladění > 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, který není doména, můžete zadat název počítače a platný název uživatelského účtu, například MJO-DL\name@something.com, spolu se správným heslem.

    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 proveďte akci pro dosažení zarážky. Měli byste vidět, že je zarážka 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í při principech souborů symbolů a nastavení symbolů sady Visual Studio.

15. Na počítači se sadou Visual Studio byste měli vidět, že se spuštění zastavilo na zarážce.

    Pokud máte nějaké soubory bez kódu, které musí aplikace používat, musíte je zahrnout do projektu sady Visual Studio. Vytvořte složku projektu pro další soubory (v Průzkumník řešení klikněte na přidat > novou složku). Potom přidejte soubory do složky (v Průzkumník řešení klikněte na Přidat > existující položku a vyberte soubory). Na stránce Vlastnosti pro každý soubor nastavte kopírovat do výstupního adresáře vždy.

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

Aplikace .NET MAUI jsou zabalené aplikace, které je potřeba zaregistrovat při nasazení, a ne jen kopí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 do vzdáleného zařízení jako rozbalenou aplikaci pomocí kroků popsaných v 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í ladění pro projekt. Před zahájením ladění ručně upravte spouštěcí soubor Nastavení.json a nahraďte hodnotu commandNameProject hodnotou , MsixPackagejak 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:

  Spuštění nelze upravit Nastavení.json v dialogovém okně Spustit ladicí profil po změně hodnoty na MsixPackage.

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

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

Ke vzdálenému symbolu spravovaného kódu můžete použít následující přepínač příkazového řádku msvsmon: Msvsmon /FallbackLoadRemoteManagedPdbs

Další informace naleznete v nápovědě k vzdálenému ladění (stiskněte klávesu F1 v okně vzdáleného ladicího programu nebo klikněte na tlačítko Využití nápovědy>).

Související obsah

• Ladění v sadě Visual Studio
• První seznámení s ladicím programem
• Konfigurace brány firewall ve Windows pro vzdálené ladění
• Přiřazení portů vzdáleného ladicího programu
• Vzdálené ladění ASP.NET na vzdáleném počítači se službou IIS
• Chyby při vzdáleném ladění a jejich řešení