C# vagy Visual Basic-projekt távoli hibakeresése a Visual Studióban

Ha egy másik számítógépen üzembe helyezett Visual Studio-alkalmazást szeretne hibakeresésre telepíteni, telepítse és futtassa a távoli eszközöket azon a számítógépen, amelyen telepítette az alkalmazást, konfigurálja a projektet úgy, hogy a Visual Studióból csatlakozzon a távoli számítógéphez, majd futtassa az alkalmazást.

Az Univerzális Windows-alkalmazások (UWP) távoli hibakereséséről további információt Telepített alkalmazáscsomagok hibakeresésecímű témakörben talál.

Követelmények

A távoli hibakereső a Windows 7 és újabb verziókban, valamint a Windows Server 2008 Service Pack 2-től kezdve támogatott. A követelmények teljes listáját a Követelményekcímű témakörben találja.

Jegyzet

A proxyn keresztül csatlakoztatott két számítógép közötti hibakeresés nem támogatott. A nagy késleltetésű vagy alacsony sávszélességű kapcsolat esetén, mint például a tárcsázós internet vagy az országok/régiók közötti internetkapcsolat, a hibakeresés nem ajánlott, mivel sikertelen lehet vagy elfogadhatatlanul lassúvá válhat.

A távoli eszközök letöltése és telepítése

A Visual Studio-gép helyett a hibakeresésre használni kívánt távoli eszközön vagy kiszolgálón töltse le és telepítse a távoli eszközök megfelelő verzióját az alábbi táblázat hivatkozásaiból.

• Töltse le a Visual Studio verziójához tartozó távoli eszközök legújabb frissítését. A Visual Studio 2022 és 2026 távoli eszközei a Visual Studio bármelyik verziójával használhatók. A Visual Studio 2022-nél korábbi távoli eszközök verziói azonban nem kompatibilisek a Visual Studio későbbi verzióival. (Ha például a Visual Studio 2019-et használja, töltse le a Visual Studio 2019 távoli eszközeinek legújabb frissítését. Ebben a forgatókönyvben ne töltse le a Visual Studio 2022 távoli eszközeit.)

• Töltse le a távoli eszközöket ugyanazzal az architektúrával, mint a számítógépre, amelyre telepíti őket. Ha például x64 operációs rendszert futtató távoli számítógépen szeretné hibakeresésre használni az x86-alkalmazásokat, telepítse az x64 távoli eszközöket. Az x86-os, ARM- vagy x64-alkalmazások ARM64 operációs rendszeren való hibakereséséhez telepítse az ARM64 távoli eszközeit.

Verzió	Link	Jegyzetek
Visual Studio 2026	Távoli eszközök	Kompatibilis a Visual Studio 2022 és újabb verzióival. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Server régebbi verzióiban a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2022	Távoli eszközök	A Visual Studio 2022 távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be a Visual Studio-előfizetés azonosítójával. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Server régebbi verzióiban a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2019	Távoli eszközök	A Visual Studio 2019 távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be a Visual Studio-előfizetés azonosítójával. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Server régebbi verzióiban a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2017	Távoli eszközök	A Visual Studio 2017 távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be a Visual Studio-előfizetés azonosítójával. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. Windows Serveren a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2015	Távoli eszközök	A Visual Studio 2015 távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be a Visual Studio-előfizetés azonosítójával. Windows Serveren a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2013	Távoli eszközök	Oldal letöltése a Visual Studio 2013 dokumentációjában
Visual Studio 2012	Távoli eszközök	Oldal letöltése a Visual Studio 2012 dokumentációjában

A távoli hibakeresőt úgy futtathatja, hogy a távoli eszközök telepítése helyett msvsmon.exe a távoli számítógépre másolja. A Távoli hibakereső konfigurációs varázslója (rdbgwiz.exe) azonban csak a távoli eszközök telepítésekor érhető el. Előfordulhat, hogy a varázslót kell használnia a konfigurációhoz, ha a távoli hibakeresőt szolgáltatásként szeretné futtatni. További információért lásd a „(Nem kötelező) A távoli hibakereső konfigurálása szolgáltatásként” szakaszt.

Jegyzet

• A Windows 10-es vagy újabb alkalmazások ARM-eszközökön való hibakereséséhez használja az ARM64-et, amely a távoli eszközök legújabb verziójával érhető el.
• Windows 10-alkalmazások Windows RT-eszközökön való hibakereséséhez használja az ARM-t, amely csak a Visual Studio 2015 távoli eszközeinek letöltésében érhető el.
• Az x64-alkalmazások ARM64 operációs rendszeren való hibakereséséhez futtassa a "x64 msvsmon.exe"-t, amely az ARM64 távoli eszközökkel van telepítve.

Borravaló

Bizonyos esetekben a leghatékonyabb lehet a távoli hibakereső futtatása egy fájlmegosztásból. További információ: Távoli hibakereső futtatása fájlmegosztásból.

A távoli hibakereső beállítása

A távoli hibakereső telepítése után kövesse az alábbi lépéseket.

1. A távoli számítógépen keresse meg és indítsa el a Távoli hibakereső a Start menüből.

   Ha nem rendelkezik rendszergazdai engedélyekkel a távoli számítógépen, kattintson a jobb gombbal a Távoli hibakereső alkalmazásra, és válassza a Futtatás rendszergazdailehetőséget. Ellenkező esetben csak indítsa el a szokásos módon.

   Ha rendszergazdaként futó vagy másik felhasználói fiók (például IIS) alatt futó folyamathoz szeretne csatolni, kattintson a jobb gombbal a Távoli hibakereső alkalmazásra, és válassza a Futtatás rendszergazdakéntlehetőséget. További információért lásd: A távoli hibakereső futtatása rendszergazdaként.

2. A távoli hibakereső első indításakor (vagy a konfigurálás előtt) megjelenik a Távoli hibakeresési konfiguráció varázsló.

   A legtöbb esetben válassza a Következő lehetőséget, amíg el nem éri a varázsló Windows Firewall konfigurálása oldalát.

   

3. Válasszon ki legalább egy hálózati típust, amelyen a távoli eszközöket használni szeretné. Ha a számítógépek tartományon keresztül csatlakoznak, ki kell választania az első elemet. Ha a számítógépek munkacsoporton vagy otthoni csoporton keresztül csatlakoznak, szükség szerint válassza a második vagy a harmadik elemet.

   Ezután válassza a Befejezés gombot a távoli hibakereső indításához.

4. Ha a konfiguráció befejeződött, megjelenik a Távoli hibakereső ablak.

   

   A távoli hibakereső most egy kapcsolatra vár. A Távoli kapcsolat konfigurációjának beállításához használja a megjelenített kiszolgálónevet és portszámot a Visual Studióban.

A távoli hibakereső leállításához válassza Fájl>Kilépéslehetőséget. Újraindíthatja a Start menüből vagy a parancssorból:

<Remote debugger installation directory>\msvsmon.exe

Jegyzet

Ha további felhasználók engedélyeit kell hozzáadnia, módosítsa a hitelesítési módot vagy a távoli hibakereső portszámát, olvassa el A távoli hibakereső konfigurálásacímű témakört.

A projekt távoli hibakeresése

A hibakereső nem tudja üzembe helyezni a Visual C# vagy a Visual Basic asztali alkalmazásokat egy távoli gépen, de az alábbiak szerint távolról is hibakeresést végezhet rajtuk. Az alábbi eljárás feltételezi, hogy hibakeresést szeretne végezni egy MJO-DLnevű számítógépen, az alábbi ábrán látható módon.

1. Hozzon létre egy MyWpfnevű WPF-projektet.

   Ha a WPF helyett egy MAUI-alkalmazást próbál távoli hibakeresésre használni, olvassa el a .NET MAUI-alkalmazások Távoli hibakeresése Windows rendszeren című témakört.

2. Állítson be egy töréspontot valahol a kódban, amely könnyen elérhető.

   Beállíthat például egy töréspontot egy gombkezelőben. Ehhez nyissa meg a MainWindow.xaml fájlt, és adjon hozzá egy gombvezérlőt az eszközkészletből, majd kattintson duplán a gombra a kezelő megnyitásához.

3. A Megoldáskezelőben kattintson a jobb gombbal a projektre, és válassza a Tulajdonságoklehetőséget.

4. A Tulajdonságok lapon válassza a Hibakeresés lapot.

   A .NET Core-t vagy a .NET 5+-t célzó C#-projektek esetében a Visual Studio 2022-től válassza a Hibakeresési indítási profilok felhasználói felületét a Hibakeresés lapon a távoli hibakeresés beállításainak konfigurálásához.

   

   Ellenkező esetben a .NET-keretrendszer esetében a távoli hibakeresési beállításokat közvetlenül a Hibakeresés lapon módosíthatja.

   

5. Győződjön meg arról, hogy a Munkakönyvtár szövegmező üres.

6. Válassza a Távoli gép használatalehetőséget, és írja be a yourmachinename:port szövegmezőbe. A portszám a távoli hibakereső ablakban jelenik meg.

   Ebben a példában használja a következőt:

   MJO-DL:4026 a Visual Studio 2022-ben

7. Győződjön meg arról, hogy a natív kód hibakeresésének engedélyezése nincs kiválasztva.

8. Hozza létre a projektet.

9. Hozzon létre egy mappát a távoli számítógépen, amely megegyezik a Visual Studio-számítógépen található hibakeresési mappával: <forrás elérési útja>\MyWPF\MyWPF\bin\Debug.

10. Másolja a Visual Studio-számítógépről az imént létrehozott végrehajtható fájlt a távoli számítógép újonnan létrehozott mappájába.

    Figyelem

    Ne módosítsa a kódot vagy ne újraépítse (különben ismételje meg ezt a lépést). A távoli gépre másolt végrehajtható fájlnak pontosan meg kell egyeznie a helyi forrással és szimbólumokkal.

    A projektet manuálisan másolhatja, használhatja az XCopyt, a Robocopyt, a PowerShellt vagy más beállításokat.

11. Győződjön meg arról, hogy a távoli hibakereső fut a célgépen (ha nem, keressen Távoli hibakereső a Start menüben). A távoli hibakereső ablak így néz ki.

    

12. A Visual Studióban indítsa el a hibakeresést (Hibakeresés > Hibakeresés indításavagy F5).

13. Ha a rendszer kéri, adja meg a hálózati hitelesítő adatokat a távoli géphez való csatlakozáshoz.

    A szükséges hitelesítő adatok a hálózat biztonsági konfigurációjától függően változnak. Egy tartományszámítógépen például megadhatja a tartománynevét és a jelszavát. Egy nem tartományi gépen megadhatja a gép nevét és egy érvényes felhasználónevet, például MJO-DL\name@something.com, a megfelelő jelszóval együtt.

    Látnia kell, hogy a WPF-alkalmazás főablaka meg van nyitva a távoli számítógépen.

14. Ha szükséges, lépjen közbe a töréspont eléréséhez. Látnia kell, hogy a töréspont aktív. Ha nem, az alkalmazás szimbólumai nem töltődnek be. Próbálkozzon újra, és ha ez nem működik, a szimbólumok betöltéséről és azok hibaelhárításáról a szimbólumfájlok és a Visual Studio szimbólumbeállításainakcímű témakörben talál információt.

15. A Visual Studio-gépen látnia kell, hogy a végrehajtás leállt a töréspontnál.

    Ha rendelkezik olyan nem kódfájlokkal, amelyeket az alkalmazásnak használnia kell, azokat bele kell foglalnia a Visual Studio-projektbe. Hozzon létre egy projektmappát a további fájlokhoz (a Megoldáskezelőkattintson > Új mappa hozzáadása). Ezután adja hozzá a fájlokat a mappához (a Megoldáskezelőkattintson a Meglévő elem hozzáadása > hozzáadásaelemre, majd jelölje ki a fájlokat). Az egyes fájlok Tulajdonságok lapján állítsa a Másolás kimeneti könyvtárba beállítást Másolás mindigértékre.

.NET MAUI-alkalmazás távoli hibakeresése Windows rendszeren

A .NET MAUI-alkalmazások olyan csomagolt alkalmazások, amelyeket üzembe helyezéskor regisztrálni kell, nem csak egy távoli gépre másolva. A távoli hibakereséshez üzembe helyezheti az alkalmazás csomagolatlan verzióját.

A távoli hibakereséshez használja az alábbi módszerek egyikét:

• Tegye közzé az alkalmazást a távoli eszközön csomagolatlan alkalmazásként a A parancssori felület használatával közzéteheti a kicsomagolt .NET MAUI-alkalmazásokat Windows, majd kövesse a cikkben leírt lépéseket a távoli hibakereséshez. (Hagyja ki a lépéseket az alkalmazás másolásához.)

• Kövesse az ebben a cikkben ismertetett lépéseket, beleértve a hibakeresési indítási profil projekthez való létrehozásához szükséges lépéseket. A hibakeresés megkezdése előtt manuálisan szerkessze a launchSettings.json fájlt, és cserélje le a parancsNévProject értékét MsixPackage, ahogy az itt látható.

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

  A hibakeresés megkezdésekor ez a módszer először telepíti az alkalmazás csomagolatlan verzióját, és elindítja azt.

  Jegyzet

  Ha az értéket -ra módosítja, nem szerkesztheti a MsixPackage elemeket a Hibakeresés indítási profil párbeszédablakban.

A hibakeresés beállítása távoli szimbólumokkal

A Visual Studio-számítógépen létrehozott szimbólumokkal képesnek kell lennie a kód hibakeresésére. A távoli hibakereső teljesítménye sokkal jobb, ha helyi szimbólumokat használ. Ha távoli szimbólumokat kell használnia, meg kell adnia a távoli hibakereső monitornak, hogy keressen szimbólumokat a távoli gépen.

A következő msvsmon parancssori kapcsolóval távoli szimbólumokat használhat felügyelt kódhoz: Msvsmon /FallbackLoadRemoteManagedPdbs

További információt a távoli hibakeresési súgóban talál (nyomja le F1 a távoli hibakereső ablakban, vagy kattintson Súgó > Használati).

Kapcsolódó tartalom

• Hibakeresés a Visual Studio-ban
• Első pillantás a hibakeresőre
• A Windows tűzfal konfigurálása távoli hibakeresési
• Távoli hibakereső portok kiosztása
• ASP.NET távoli hibakeresése egy távoli IIS-számítógépen
• Távoli hibakeresési problémák és hibaelhárítás