Hosten und Bereitstellen von ASP.NET Core Blazor

In diesem Artikel wird erläutert, wie Sie Blazor-Apps hosten und bereitstellen.

Veröffentlichen der App

Apps werden für die Bereitstellung in Releasekonfigurationen veröffentlicht.

dotnet publish

dotnet publish -c Release

Das Veröffentlichen einer App löst eine Wiederherstellung der Abhängigkeiten des Projekts aus und erstellt das Projekt, bevor die Objekte für die Bereitstellung erstellt werden. Im Rahmen des Buildprozesses werden nicht verwendete Methoden und Assemblys entfernt, um die Downloadgröße und Ladezeiten von Apps zu reduzieren.

Leeren des Zielveröffentlichungsordners

Wenn Sie den dotnet publish Befehl in einer Befehlsshell zum Veröffentlichen einer App verwenden, generiert der Befehl die erforderlichen Dateien für die Bereitstellung basierend auf dem aktuellen Status des Projekts und platziert die Dateien in den angegebenen Ausgabeordner. Der Befehl bereinigt den Zielordner nicht automatisch, bevor die App veröffentlicht wird.

Um den Zielordner automatisch zu leeren, bevor die App veröffentlicht wird, fügen Sie das folgende MSBuild-Ziel zur Projektdatei der App (.csproj) unter dem Stammelement <Project> hinzu:

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

Standardveröffentlichungsorte

IIS

Informationen zum Hosten einer Blazor-App in IIS finden Sie in den folgenden Ressourcen:

• IIS-Hosting
  • Veröffentlichen einer ASP.NET Core-App in IIS
  • Hosten Sie ASP.NET Core unter Windows mit IIS
• Hosten und Bereitstellen von serverseitigen ASP.NET Core Blazor Apps: Blazor Web Apps (.NET 8 oder höher) und Blazor Server Apps (.NET 7 oder früher), die auf IIS ausgeführt werden, einschließlich IIS mit Azure Virtual Machines (VMs) auf dem Windows-Betriebssystem und Azure App Service.
• Hosten und Bereitstellen ASP.NET Core Blazor WebAssembly mit IIS: Eigenständige Blazor WebAssembly Apps (alle .NET-Versionen) und gehostete Blazor WebAssembly Apps (.NET 7 oder früher).
• IIS-Hosting untergeordneter Anwendungen
  • Folgen Sie den Anleitungen für den App-Basispfad vor der Veröffentlichung der App. In den Beispielen wird der App-Basispfad /CoolApp verwendet und gezeigt, wie Sie den Basispfad aus App-Einstellungen oder anderen Konfigurationsanbietern abrufen.
  • Folgen Sie der Anleitung zum Konfigurieren untergeordneter Anwendungen unter Erweiterte Konfiguration. Der Ordnerpfad der untergeordneten App unter der Stammwebsite wird zum virtuellen Pfad der untergeordneten App. Bei einem App-Basispfad wie /CoolApp wird die Blazor-App in einem Ordner mit dem Namen CoolApp unter der Stammwebsite platziert, und die untergeordnete App verwendet einen virtuellen Pfad (/CoolApp).

Das Freigeben eines App-Pools zwischen ASP.NET Core-Apps wird nicht unterstützt, auch nicht für Blazor-Apps. Verwenden Sie beim Hosten mit IIS einen App-Pool pro App, und vermeiden Sie die Verwendung der virtuellen IIS-Verzeichnisse zum Hosten mehrerer Apps.

<WasmBundlerFriendlyBootConfig>true</WasmBundlerFriendlyBootConfig>

Blazor Server MapFallbackToPage Konfiguration

Dieser Abschnitt gilt nur für Blazor Server-Apps. MapFallbackToPage wird nicht in Blazor Web App- und Blazor WebAssembly -Apps unterstützt.

Falls eine App einen separaten Bereich mit benutzerdefinierten Ressourcen und Razor-Komponenten erfordert:

• Erstellen Sie im Ordner Pages der App einen Ordner für die Ressourcen. Der Administratorbereich einer App wird beispielsweise in einem Ordner namens Admin (Pages/Admin) erstellt.

• Erstellen Sie eine Stammseite (_Host.cshtml) für den Bereich. Erstellen Sie beispielsweise eine Pages/Admin/_Host.cshtml-Datei aus der Hauptstammseite der App (Pages/_Host.cshtml). Geben Sie auf der @page-Seite für Administrator*innen keine _Host-Anweisung an.

• Fügen Sie dem Ordner des Bereichs ein Layout hinzu (z. B. Pages/Admin/_Layout.razor). Legen Sie das <base>-Tag href im Layout für den separaten Bereich so fest, dass es mit dem Ordner des Bereichs übereinstimmt (z. B. <base href="/Admin/" />). Fügen Sie zu Demonstrationszwecken ~/ zu den statischen Ressourcen auf der Seite hinzu. Zum Beispiel:

  • ~/css/bootstrap/bootstrap.min.css
  • ~/css/site.css
  • ~/BlazorSample.styles.css (der Namespace der Beispiel-App lautet BlazorSample)
  • ~/_framework/blazor.server.js (Blazor Script)

• Wenn der Bereich über einen eigenen Ordner für statische Ressourcen verfügen soll, fügen Sie den Ordner hinzu und geben Sie in Program.cs den Speicherort für die Middleware für statische Dateien an (z. B. app.UseStaticFiles("/Admin/wwwroot")).

• Razor-Komponenten werden dem Ordner des Bereichs hinzugefügt. Fügen Sie dem Bereichsordner mindestens eine Index-Komponente mit der richtigen @page-Anweisung für den Bereich hinzu. Fügen Sie beispielsweise eine Pages/Admin/Index.razor-Datei hinzu, die auf der Pages/Index.razor-Standarddatei der App basiert. Geben Sie den Bereich Admin als Routenvorlage am Anfang der Datei an (@page "/admin"). Fügen Sie bei Bedarf zusätzliche Komponenten hinzu. Geben Sie beispielsweise Pages/Admin/Component1.razor mit einer @page-Anweisung und der Routenvorlage @page "/admin/component1 an.

• Rufen Sie in Program.cs die Methode MapFallbackToPage für den Anforderungspfad des Bereichs unmittelbar vor dem Pfad der Fallbackstammseite auf die _Host-Seite auf:

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