ASP.NET Core-Blazor hosten en implementeren

In dit artikel wordt uitgelegd hoe u Blazor apps host en implementeert.

De app publiceren

Apps worden gepubliceerd voor implementatie in de releaseconfiguratie.

dotnet publish

dotnet publish -c Release

Als u de app publiceert, wordt een herstel van de afhankelijkheden van het project geactiveerd en het project bouwt voordat u de assets voor implementatie maakt. Als onderdeel van het buildproces worden ongebruikte methoden en assembly's verwijderd om de downloadgrootte en laadtijden van apps te verminderen.

De doelpublicatiemap leegmaken

Wanneer u de dotnet publish opdracht in een opdrachtshell gebruikt om een app te publiceren, genereert de opdracht de benodigde bestanden voor implementatie op basis van de huidige status van het project en plaatst u de bestanden in de opgegeven uitvoermap. De opdracht maakt de doelmap niet automatisch schoon voordat de app wordt gepubliceerd.

Als u de doelmap automatisch wilt leegmaken voordat de app wordt gepubliceerd, voegt u het volgende MSBuild-doel toe aan het projectbestand van de app (.csproj) onder het hoofdelement <Project> :

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

Standaardpubliceerlocaties

IIS

Als u een Blazor-app in IIS wilt hosten, raadpleegt u de volgende bronnen:

• IIS-hosting
  • Een ASP.NET Core-app publiceren naar IIS-
  • Host ASP.NET Core op Windows met IIS
• Host en implementeer ASP.NET Core-apps aan de serverzijdeBlazor: Blazor Web Apps (.NET 8 of hoger) en Blazor Server apps (.NET 7 of lager) die worden uitgevoerd op IIS, waaronder IIS met Virtuele Machines (VM's) met Windows OS en Azure App Service.
• Host en implementeer ASP.NET Core Blazor WebAssembly met IIS: Zelfstandige Blazor WebAssembly apps (alle .NET-releases) en gehoste Blazor WebAssembly apps (.NET 7 of eerder).
• Hosting van IIS-subtoepassingen
  • Volg de richtlijnen voor het basispad van de app voordat u de app publiceert. In de voorbeelden wordt een app-basispad van /CoolApp gebruikt en wordt uitgelegd hoe u het basispad kunt verkrijgen van app-instellingen of andere configuratieproviders.
  • Volg de richtlijnen voor subtoepassingsconfiguratie in Geavanceerde configuratie. Het mappad van de sub-app onder de hoofdsite wordt het virtuele pad van de sub-app. Voor een app-basispad van /CoolAppwordt de Blazor app geplaatst in een map met de naam CoolApp onder de hoofdsite en neemt de sub-app een virtueel pad van /CoolAppop.

Het delen van een app-pool tussen ASP.NET Core-apps wordt niet ondersteund, waaronder voor Blazor-apps. Gebruik één app-pool per app bij het hosten met IIS en vermijd het gebruik van de virtuele mappen van IIS voor het hosten van meerdere apps.

<WasmBundlerFriendlyBootConfig>true</WasmBundlerFriendlyBootConfig>

configuratie van Blazor ServerMapFallbackToPage

Deze sectie is alleen van toepassing op Blazor Server apps. MapFallbackToPage wordt niet ondersteund in Blazor Web App- en Blazor WebAssembly-apps.

In scenario's waarin een app een afzonderlijk gebied met aangepaste resources en Razor onderdelen vereist:

• Maak een map in de Pages map van de app om de resources op te slaan. Een beheerderssectie van een app wordt bijvoorbeeld gemaakt in een nieuwe map met de naam Admin (Pages/Admin).

• Maak een hoofdpagina (_Host.cshtml) voor het gebied. Maak bijvoorbeeld een Pages/Admin/_Host.cshtml bestand op basis van de hoofdpagina van de app (Pages/_Host.cshtml). Geef geen @page-instructie op de Beheer-pagina _Host.

• Voeg een indeling toe aan de map van het gebied (bijvoorbeeld Pages/Admin/_Layout.razor). Stel in de indeling voor het aparte gebied de <base>-tag op href zodat deze past bij de map van het gebied (bijvoorbeeld <base href="/Admin/" />). Voeg voor demonstratiedoeleinden ~/ toe aan de statische resources op de pagina. Bijvoorbeeld:

  • ~/css/bootstrap/bootstrap.min.css
  • ~/css/site.css
  • ~/BlazorSample.styles.css (de naamruimte van de voorbeeld-app is BlazorSample)
  • ~/_framework/blazor.server.js (Blazor script)

• Als het gebied een eigen statische assetmap moet hebben, voegt u de map toe en geeft u de locatie op aan Static File Middleware in Program.cs (bijvoorbeeld app.UseStaticFiles("/Admin/wwwroot")).

• Razor-onderdelen worden toegevoegd aan de map voor dit gebied. Voeg minimaal een Index onderdeel toe aan de gebiedsmap met de juiste @page instructie voor het gebied. Voeg bijvoorbeeld een Pages/Admin/Index.razor-bestand toe op basis van het standaardbestand Pages/Index.razor van de app. Geef het beheergebied aan als de routesjabloon boven aan het bestand (@page "/admin"). Voeg indien nodig extra onderdelen toe. Bijvoorbeeld Pages/Admin/Component1.razor met een @page richtlijn en routesjabloon van @page "/admin/component1.

• Roep in Program.csMapFallbackToPage aan voor het aanvraagpad van het gebied direct voor het pad naar de terugvalhoofdpagina naar de _Host pagina:

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