Vara värd för och distribuera ASP.NET Core Blazor

Den här artikeln beskriver hur du hostar och driftsätter Blazor-appar.

Publicera appen

Appar publiceras för distribution i Release-konfiguration.

dotnet publish

dotnet publish -c Release

När appen publiceras utlöses en återställning av projektets beroenden och bygger projektet innan du skapar resurserna för distribution. Som en del av byggprocessen tas oanvända metoder och sammansättningar bort för att minska appens nedladdningsstorlek och inläsningstider.

Töm målpubliceringsmappen

När du använder dotnet publish kommandot i ett kommandogränssnitt för att publicera en app genererar kommandot nödvändiga filer för distribution baserat på projektets aktuella tillstånd och placerar filerna i den angivna utdatamappen. Kommandot rensar inte målmappen automatiskt innan appen publiceras.

Om du vill tömma målmappen automatiskt innan appen publiceras lägger du till följande MSBuild-mål i appens projektfil (.csproj) under rotelementet <Project> :

<Target Name="_RemovePublishDirBeforePublishing" BeforeTargets="BeforePublish">
  <RemoveDir Directories="$(PublishDir)" Condition="'$(PublishDir)' != ''" />
</Target>

Standardpubliceringsplatser

IIS

För att vara värd för en Blazor app i IIS, kan du se följande resurser:

• IIS-värdtjänst
  • Publicera en ASP.NET Core-app till IIS-
  • Host ASP.NET Core i Windows med IIS
• Värdhantera och distribuera ASP.NET Core-appar på serversidanBlazor: Blazor Web Apps (.NET 8 eller senare) och Blazor Server appar (.NET 7 eller tidigare) som körs på IIS, inklusive IIS med virtuella Azure-datorer som kör Windows OS och Azure App Service.
• Hantera och distribuera ASP.NET Core Blazor WebAssembly med IIS: Fristående Blazor WebAssembly appar (alla .NET-versioner) och värdbaserade Blazor WebAssembly appar (.NET 7 eller tidigare).
• IIS-värd för underapplikation
  • Följ vägledningen för appbassökvägen innan du publicerar appen. Exemplen använder appens bassökväg /CoolApp och visar hur du hämtar bassökvägen från appinställningar eller andra konfigurationsleverantörer.
  • Följ konfigurationsguiden för underprogram i Avancerad konfiguration. Underappens mappsökväg under rotplatsen blir den virtuella sökvägen för underappen. För en appbassökväg för /CoolAppplaceras Blazor-appen i en mapp med namnet CoolApp under rotwebbplatsen och underappen använder en virtuell sökväg för /CoolApp.

Delning av en apppool mellan ASP.NET Core-appar stöds inte, inklusive för Blazor appar. Använd en apppool per app när du är värd för IIS och undvik att använda IIS virtuella kataloger för att vara värd för flera appar.

<WasmBundlerFriendlyBootConfig>true</WasmBundlerFriendlyBootConfig>

Blazor Server MapFallbackToPage konfiguration

Det här avsnittet gäller endast för Blazor Server appar. MapFallbackToPage stöds inte i Blazor Web Appoch Blazor WebAssembly appar.

I scenarier där en app kräver ett separat område med anpassade resurser och Razor komponenter:

• Skapa en mapp i appens Pages mapp för att lagra resurserna. Ett administratörsavsnitt i en app skapas till exempel i en ny mapp med namnet Admin (Pages/Admin).

• Skapa en rotsida (_Host.cshtml) för området. Skapa till exempel en Pages/Admin/_Host.cshtml fil från appens huvudrotsida (Pages/_Host.cshtml). Ge inte ett @page-direktiv på Admin _Host-sidan.

• Lägg till en layout i områdets mapp (till exempel Pages/Admin/_Layout.razor). I layouten för det separata området anger du taggen <base>href så att den matchar områdets mapp (till exempel <base href="/Admin/" />). I demonstrationssyfte lägger du till ~/ till de statiska resurserna på sidan. Till exempel:

  • ~/css/bootstrap/bootstrap.min.css
  • ~/css/site.css
  • ~/BlazorSample.styles.css (exempelappens namnområde är BlazorSample)
  • ~/_framework/blazor.server.js (Blazor skript)

• Om området ska ha en egen statisk tillgångsmapp lägger du till mappen och anger dess plats till Static File Middleware i Program.cs (till exempel app.UseStaticFiles("/Admin/wwwroot")).

• Razor-komponenterna läggs till i områdets mapp. Lägg åtminstone till Index-komponenten i områdesmappen med det rätta @page-direktivet för området. Lägg till exempel till en Pages/Admin/Index.razor fil baserat på appens standardfil Pages/Index.razor. Ange administrationsområdet som routningsmall överst i filen (@page "/admin"). Lägg till ytterligare komponenter efter behov. Till exempel Pages/Admin/Component1.razor med ett @page-direktiv och en vägmall för @page "/admin/component1.

• I Program.csanropar du MapFallbackToPage för områdets sökväg för begäran omedelbart före rotsidans återställningssökväg till _Host-sidan:

  ...
  app.UseRouting();
  
  app.MapBlazorHub();
  app.MapFallbackToPage("~/Admin/{*clientroutes:nonfile}", "/Admin/_Host");
  app.MapFallbackToPage("/_Host");
  
  app.Run();