Debuggen op afstand van ASP.NET Core op Azure App Service (Windows)

In dit artikel wordt beschreven hoe u het Foutopsporingsprogramma van Visual Studio koppelt aan een ASP.NET Core-app die wordt uitgevoerd in Azure App Service. Met de volgende stappen kunt u fouten opsporen in de app alsof deze lokaal wordt uitgevoerd.

Vereiste voorwaarden

• Visual Studio 2022 met de ASP.NET en webontwikkeling en de Azure-ontwikkelworkload geïnstalleerd.

• U moet eerst een ASP.NET Core-app implementeren in Azure App Service (Windows) vanuit Visual Studio en de app moet worden uitgevoerd.

  Zie Externe foutopsporing ASP.NET Core in Azure voor praktische training met App Service-implementatie.

• Uw publicatieprofiel in Visual Studio moet zijn ingesteld op Foutopsporing in plaats van Release voordat u publiceert.

Externe foutopsporing inschakelen

Voordat u dit probleem met Visual Studio kunt opsporen, moet u de functie voor externe foutopsporing inschakelen in de App Service. Met deze instelling kan het Visual Studio-foutopsporingsprogramma verbinding maken met het hoofdproces van app Service-webhosting.

1. Meld u aan bij uw eigen Azure-portal.

   Zoek uw geïmplementeerde toepassing in Azure Portal. U kunt uw app vinden door naar de App Services-pagina te bladeren en vervolgens het App Service-exemplaar te selecteren. U kunt ook rechtstreeks op naam naar het App Service-exemplaar zoeken in de zoekbalk bovenaan. (In dit voorbeeld heeft het App Service-exemplaar de naam GitHubBrowser123.)

   

2. Selecteer op de pagina Instellingen voor het App Service-exemplaar configuratie in het linkernavigatievenster en kies vervolgens het tabblad Algemene instellingen .

3. Zorg ervoor dat u onder aan de pagina de functie Externe foutopsporing instelt op Aan en Selecteer Visual Studio 2022 als de remote Visual Studio-versie.

   

4. Selecteer Opslaan boven aan de pagina om uw wijzigingen te behouden.

Uw App Service-exemplaar biedt nu ondersteuning voor externe foutopsporing via Visual Studio.

Instellingen voor foutopsporing configureren

1. Bouw uw app zonder fouten. Stop uw app als deze lokaal wordt uitgevoerd.

   Opmerking

   Zorg ervoor dat de status van uw lokale code overeenkomt met wat is geïmplementeerd in Azure. Dit zorgt ervoor dat de lokale symboolbestanden en broncode worden afgestemd op de geïmplementeerde app.

2. Selecteer Opties voor foutopsporing > in het bovenste Menu van Visual Studio. Zorg ervoor dat Alleen mijn code inschakelenuitgeschakeld is (zoals hieronder wordt weergegeven) en selecteer vervolgens OK.

   Als u deze instelling wijzigt, kan Visual Studio fouten opsporen in de geoptimaliseerde code die is geïmplementeerd in Azure met behulp van de benodigde symboolbestanden uit uw lokale bin-map. Symboolbestanden worden door het foutopsporingsprogramma gebruikt als een brug tussen gecompileerde, uitgevoerde code en de broncode in Visual Studio. Overeenkomende symboolbestanden zijn vereist voor foutopsporing op afstand.

   

Het foutopsporingsprogramma koppelen aan de App Service

1. Selecteer in het hoofdmenu boven aan Visual Studio Debug > Attach to process om het bijbehorende dialoogvenster te openen. Met dit venster kunt u verbinding maken en koppelen aan verschillende doelen. In dit geval maakt u verbinding met het App Service-exemplaar dat u in de vorige stap hebt gemaakt.

2. Selecteer de vervolgkeuzelijst Verbindingstype en kies de optie Microsoft Azure App Services .

3. Selecteer Zoeken.. naast het veld Verbindingsdoel om een dialoogvenster te openen waarmee u door uw Azure-abonnementen en app-services kunt bladeren.

   Als u nog niet bent aangemeld met uw Azure-abonnement, selecteert u Zoeken... en vervolgens kunt u zich aanmelden.

4. Zoek en selecteer het App Service-exemplaar dat u in de vorige stap hebt gemaakt en kies VERVOLGENS OK.

5. Het w3wp.exe proces moet worden weergegeven in de lijst met beschikbare processen waarmee u verbinding wilt maken. w3wp.exe is het belangrijkste proces van de Azure App Service die als host fungeert voor de geïmplementeerde toepassing. Selecteer het w3wp.exe proces en kies Vervolgens rechtsonder bijvoegen .

   

6. Stel in een C#-toepassingsbestand zoals Index.cshtml.cseen onderbrekingspunt in door in de linkermarge te klikken. U kunt ook met de rechtermuisknop klikken en onderbrekingspunt> invoegen kiezen.

7. Navigeer in de web-app naar het eindpunt met het onderbrekingspunt. Als u aan het proces bent gekoppeld, maar het onderbrekingspunt niet kunt bereiken, controleert u of uw publicatieprofiel in Visual Studio is ingesteld op een foutopsporingsconfiguratie in plaats van een releaseconfiguratie.

8. Optioneel: Om te controleren of Visual Studio de symboolbestanden voor uw foutopsporingssessie heeft geladen. Navigeer naar Fouten opsporen in > Windows-modules > om het venster modules te openen. Dit venster geeft aan dat de symboolbestanden zijn geladen na de wijzigingen in de configuratie van Alleen mijn code die u eerder hebt aangebracht.