Een ASP.NET-app configureren voor Azure App Service

Notitie

Zie Een ASP.NET Core-app configureren voor Azure-app Service voor ASP.NET Core voor ASP.NET Core. Als uw ASP.NET-app wordt uitgevoerd in een aangepaste Windows- of Linux-container, raadpleegt u Een aangepaste container configureren voor Azure-app Service.

ASP.NET apps moeten worden geïmplementeerd in Azure-app Service als gecompileerde binaire bestanden. Het Visual Studio-publicatieprogramma bouwt de oplossing en implementeert vervolgens de gecompileerde binaire bestanden rechtstreeks, terwijl de App Service-implementatie-engine eerst de codeopslagplaats implementeert en vervolgens de binaire bestanden compileert.

Deze handleiding bevat belangrijke concepten en instructies voor ASP.NET ontwikkelaars. Als u Azure-app Service nog nooit hebt gebruikt, volgt u eerst de quickstart ASP.NET en ASP.NET met sql Database.

Ondersteunde .NET Framework-runtimeversies weergeven

In App Service hebben de Windows-exemplaren al alle ondersteunde .NET Framework-versies geïnstalleerd. Als u de .NET Framework-runtime- en SDK-versies wilt weergeven die voor u beschikbaar zijn, gaat u naar https://<app-name>.scm.azurewebsites.net/DebugConsole de juiste opdracht en voert u deze uit in de browserconsole:

Voor CLR 4 runtime-versies (.NET Framework 4 en hoger):

CMD

ls "D:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework"

De nieuwste versie van .NET Framework is mogelijk niet direct beschikbaar.

Voor CLR 2-runtimeversies (.NET Framework 3.5 en hieronder):

CMD

ls "D:\Program Files (x86)\Reference Assemblies\Microsoft\Framework"

Huidige runtimeversie van .NET Framework weergeven

Voer de volgende opdracht uit in Cloud Shell:

Azure CLI

az webapp config show --resource-group <resource-group-name> --name <app-name> --query netFrameworkVersion

De meest v4.0 recente CLR 4-versie (.NET Framework 4.x) wordt gebruikt. Een waarde van v2.0 de waarde van een CLR 2-versie (.NET Framework 3.5) wordt gebruikt.

Runtimeversie van .NET Framework instellen

Standaard gebruikt App Service de meest recente ondersteunde .NET Framework-versie om uw ASP.NET-app uit te voeren. Als u uw app wilt uitvoeren met .NET Framework 3.5, voert u in plaats daarvan de volgende opdracht uit in Cloud Shell (v2.0 geeft CLR 2 aan):

Azure CLI

az webapp config set --resource-group <resource-group-name> --name <app-name> --net-framework-version v2.0

Toegang tot omgevingsvariabelen

In App Service kunt u app-instellingen en verbindingsreeks s buiten uw app-code instellen. Vervolgens kunt u ze in elke klasse openen met behulp van het standaardpatroon ASP.NET:

C#

using System.Configuration;
...
// Get an app setting
ConfigurationManager.AppSettings["MySetting"];
// Get a connection string
ConfigurationManager.ConnectionStrings["MyConnection"];
}

Als u een app-instelling met dezelfde naam in App Service en in web.config configureert, heeft de App Service-waarde voorrang op de web.config-waarde . Met de lokale web.config-waarde kunt u lokaal fouten opsporen in de app, maar met de App Service-waarde kunt u de app uitvoeren in het product met productie-instellingen. Verbindingsreeksen werken op dezelfde manier. Op deze manier kunt u uw toepassingsgeheimen buiten uw codeopslagplaats bewaren en toegang krijgen tot de juiste waarden zonder uw code te wijzigen.

Notitie

Overweeg veiligere connectiviteitsopties die helemaal geen verbindingsgeheimen vereisen. Zie Secure connectivity to Azure services and databases from Azure-app Service (Beveiligde connectiviteit met Azure-services en -databases) voor meer informatie.

Oplossingen voor meerdere projecten implementeren

Wanneer een Visual Studio-oplossing meerdere projecten bevat, omvat het publicatieproces van Visual Studio al het te implementeren project. Wanneer u implementeert in de App Service-implementatie-engine, zoals met Git of met ZIP-implementatie waarvoor buildautomatisering is ingeschakeld, kiest de App Service-implementatie-engine de eerste website of het webtoepassingsproject dat wordt gevonden als de App Service-app. U kunt opgeven welk project App Service moet gebruiken door de PROJECT app-instelling op te geven. Voer bijvoorbeeld het volgende uit in Cloud Shell:

Azure CLI

az webapp config appsettings set --resource-group <resource-group-name> --name <app-name> --settings PROJECT="<project-name>/<project-name>.csproj"

Pagina met gedetailleerde uitzonderingen ophalen

Wanneer uw ASP.NET-app een uitzondering genereert in het foutopsporingsprogramma van Visual Studio, wordt in de browser een gedetailleerde uitzonderingspagina weergegeven, maar in App Service wordt die pagina vervangen door een algemeen foutbericht. Als u de gedetailleerde uitzonderingspagina in App Service wilt weergeven, opent u het bestand Web.config en voegt u het <customErrors mode="Off"/> element toe onder het <system.web> element. Voorbeeld:

XML

<system.web>
    <customErrors mode="Off"/>
</system.web>

Implementeer uw app opnieuw met de bijgewerkte Web.config. U ziet nu dezelfde gedetailleerde uitzonderingspagina.

Toegang tot diagnostische logboeken

U kunt diagnostische berichten toevoegen in uw toepassingscode met behulp van System.Diagnostics.Trace. Voorbeeld:

C#

Trace.TraceError("Record not found!"); // Error trace
Trace.TraceWarning("Possible data loss"); // Warning trace
Trace.TraceInformation("GET /Home/Index"); // Information trace

Als u toegang wilt tot de consolelogboeken die worden gegenereerd binnen uw toepassingscode in de App Service, schakelt u diagnostische logboekregistratie in door de volgende opdracht in de Cloud Shell uit te voeren:

Azure CLI

az webapp log config --resource-group <resource-group-name> --name <app-name> --docker-container-logging filesystem --level Verbose

Mogelijk waarden voor --level zijn: Error, Warning, Info en Verbose. Elk hoger niveau omvat het vorige niveau. Bijvoorbeeld: Error omvat alleen foutberichten en Verbose omvat alle berichten.

Nadat diagnostische logboekregistratie is ingeschakeld, voert u de volgende opdracht uit om de logboekstream te zien:

Azure CLI

az webapp log tail --resource-group <resource-group-name> --name <app-name>

Als u de consolelogboeken niet meteen ziet, probeert u het opnieuw na 30 seconden.

Notitie

U kunt ook de logboekbestanden van de browser inspecteren op https://<app-name>.scm.azurewebsites.net/api/logs/docker.

U kunt op elk gewenst moment Ctrl+C typen om te stoppen met logboekstreaming.

Meer resources

• Zelfstudie: Een ASP.NET-app bouwen in Azure met SQL Database
• Naslaginformatie over omgevingsvariabelen en app-instellingen