Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Dies ist nicht die neueste Version dieses Artikels. Die aktuelle Version finden Sie in der .NET 11-Version dieses Artikels.
Warnung
Diese Version von ASP.NET Core wird nicht mehr unterstützt. Weitere Informationen finden Sie in der .NET- und .NET Core-Supportrichtlinie. Die aktuelle Version finden Sie in der .NET 10-Version dieses Artikels.
In diesem Artikel werden die Dateien und Ordner beschrieben, aus denen eine Blazor-App besteht, die aus einer Blazor-Projektvorlage generiert wurde.
Blazor Web App
Blazor Web App Projektvorlage: blazor
Die Blazor Web App-Projektvorlage stellt einen einzigen Ausgangspunkt für die Verwendung von Razor-Komponenten (.razor) bereit, um jede Art von Web-UI zu erstellen, sowohl serverseitig als auch clientseitig gerendert. Es kombiniert die Stärken von Blazor Server und Blazor WebAssembly mit serverseitigem und clientseitigem Rendering, Streaming-Rendering, verbesserter Navigation und Formularverarbeitung sowie der Möglichkeit, Interaktivität pro Komponente entweder mithilfe von Blazor Server oder Blazor WebAssembly hinzuzufügen.
Wenn sowohl clientseitiges Rendering (CSR) als auch interaktives serverseitiges Rendering (interaktiver SSR) bei der App-Erstellung ausgewählt werden, verwendet die Projektvorlage den interaktiven automatischen Rendermodus. Der Renderingmodus „automatisch“ verwendet zunächst interaktives SSR, während das App Bundle für .NET und die Runtime im Browser heruntergeladen werden. Nachdem die .NET WebAssembly-Runtime aktiviert wurde, wechselt der Rendermodus zu CSR.
Die Blazor Web App-Vorlage ermöglicht sowohl statisches als auch interaktives serverseitiges Rendering in einem einzigen Projekt. Wenn Sie außerdem das interaktive WebAssembly-Rendering aktivieren, enthält das Projekt ein zusätzliches Clientprojekt (.Client) für Ihre WebAssembly-basierten Komponenten. Die Buildausgabe des Clientprojekts wird im Browser heruntergeladen und auf dem Client ausgeführt. Alle Komponenten, die den Rendermodus „Interaktives WebAssembly“ oder „Interaktiv Automatisch“ verwenden, müssen im .Client-Projekt enthalten sein.
Die Ordnerstruktur von Komponenten im .Client-Projekt unterscheidet sich von der des Hauptprojekts der Blazor Web App, da das Hauptprojekt ein ASP.NET Core-Standardprojekt ist. Das Hauptprojekt muss noch andere Ressourcen für ASP.NET Core-Projekte berücksichtigen, die nicht im Zusammenhang mit Blazor stehen. Sie können im .Client-Projekt jede beliebige Komponentenordnerstruktur verwenden. Sie können im .Client-Projekt auch die Ordnerstruktur der Komponenten des Hauptprojekts nachbilden, wenn Sie möchten. Beachten Sie, dass Namespaces möglicherweise Anpassungen für Objekte wie Layoutdateien erfordern, wenn Sie Komponenten in Ordner verschieben, die nicht von der Projektvorlage verwendet werden.
Weitere Informationen zu Komponenten und Rendermodi finden Sie in den Artikeln ASP.NET Core Razor Komponenten und ASP.NET Core Blazor Rendermodi.
Je nach dem bei der Erstellung der App ausgewählten interaktiven Rendering-Modus befindet sich der Ordner Layout entweder im Server-Projekt im Ordner Components oder im Stammverzeichnis des Projekts .Client. Der -Ordner enthält die folgenden Layoutkomponenten und Stylesheets:
- Die
MainLayout-Komponente (MainLayout.razor) ist die Layout-Komponente der App. - Das
MainLayout.razor.cssist das benachbarte Stylesheet (neben der Komponente) für das Hauptlayout der App. - Die
NavMenu-Komponente (NavMenu.razor) implementiert die Navigation in der Seitenleiste. Die Komponente enthältNavLinkKomponenten (NavLink), die Navigationslinks zu anderen Razor Komponenten darstellen. Die NavLink-Komponente gibt für Benutzer*innen an, welche Komponente derzeit angezeigt wird. - Das
NavMenu.razor.cssist das zusammengestellte Stylesheet für das Navigationsmenü der App. - Die
ReconnectModalKomponente spiegelt den serverseitigen Verbindungszustand in der Benutzeroberfläche wider und wird einbezogen, wenn der interaktive Rendermodus der App entweder interactive Server oder Interactive Auto ist. Weitere Informationen finden Sie unter ASP.NET Core-LeitfadenBlazorSignalR. - Dieses
ReconnectModal.razor.cssist das kollokierte Stylesheet für dieReconnectModalKomponente. - Dieses
ReconnectModal.razor.jsist die zugehörige JavaScript-Datei für dieReconnectModal-Komponente.
- Die
MainLayout-Komponente (MainLayout.razor) ist die Layout-Komponente der App. - Das
MainLayout.razor.cssist das benachbarte Stylesheet (neben der Komponente) für das Hauptlayout der App. - Die
NavMenu-Komponente (NavMenu.razor) implementiert die Navigation in der Seitenleiste. Die Komponente enthältNavLinkKomponenten (NavLink), die Navigationslinks zu anderen Razor Komponenten darstellen. Die NavLink-Komponente gibt für Benutzer*innen an, welche Komponente derzeit angezeigt wird. - Das
NavMenu.razor.cssist das zusammengestellte Stylesheet für das Navigationsmenü der App.
Die Routes-Komponente (Routes.razor) befindet sich entweder im Server-Projekt oder im .Client-Projekt und legt das Routing mit der Router-Komponente fest. Bei clientseitigen interaktiven Komponenten fängt die Router-Komponente die Browsernavigation ab und rendert die Seite, die der angeforderten Adresse entspricht.
Der Ordner Components des Serverprojekts enthält die serverseitigen Razor Komponenten der App. Gemeinsam genutzte Komponenten befinden sich häufig im Stammverzeichnis des Ordners Components, während Layout- und Seitenkomponenten in der Regel in Ordnern innerhalb des Ordners Components abgelegt werden.
Der Components/Pages-Ordner des Server-Projekts enthält die routbaren serverseitigen Razor-Komponenten der App. Die Route für jede Seite wird mithilfe der @page-Anweisung angegeben.
Die NotFound Komponente (NotFound.razor) implementiert eine Nicht gefundene Seite, die angezeigt wird, wenn Inhalte für einen Anforderungspfad nicht gefunden werden. Weitere Informationen finden Sie unter ASP.NET Core-NavigationBlazor.
Die App-Komponente (App.razor) ist die Stammkomponente der App mit HTML <head>-Markup, der Routes-Komponente und dem Blazor<script>-Tag. Die Stammkomponente ist die erste Komponente, die die App lädt.
Eine Importdatei (_Imports.razor) in jedem der Server- und .Client-Projekte enthält allgemeine Razor-Direktiven für Razor-Komponenten beider Projekte, wie etwa @using-Direktiven für Namespaces.
Der Ordner Properties des Serverprojekts enthält die Konfiguration der Entwicklungsumgebung in der Datei launchSettings.json.
Hinweis
Wenn eine App mit der .NET CLI ausgeführt wird, wird standardmäßig das erste Startprofil in launchSettings.json verwendet, dessen commandName gleich Project ist. Um ein anderes Profil (z. B. https) zu verwenden, geben Sie die Option -lp|--launch-profile an dotnet watch oder dotnet run weiter, oder verschieben Sie das bevorzugte Profil an den Anfang der Datei.
Der wwwroot-Ordner des Server-Projekts ist der Webstamm-Ordner für das Server-Projekt, der die öffentlichen statischen Assets der App enthält.
Die Program.cs-Datei des Serverprojekts ist der Einstiegspunkt des Projekts, der den Host der ASP.NET Core-Webanwendung festlegt und die Startlogik der App enthält, einschließlich Dienstregistrierungen, Konfiguration, Protokollierung und Pipeline für die Anforderungsverarbeitung:
- Dienste für Razor-Komponenten werden durch Aufrufen von AddRazorComponents hinzugefügt. AddInteractiveServerComponents fügt Dienste hinzu, um das Rendern interaktiver Serverkomponenten zu unterstützen. AddInteractiveWebAssemblyComponents fügt Dienste hinzu, um das Rendern interaktiver WebAssembly-Komponenten zu unterstützen.
-
MapRazorComponents ermittelt verfügbare Komponenten und gibt die Stammkomponente für die App an (die erste geladene Komponente), die standardmäßig die
AppKomponente (App.razor) ist. AddInteractiveServerRenderMode konfiguriert das interaktive serverseitige Rendering (interaktive sSR) für die App. AddInteractiveWebAssemblyRenderMode konfiguriert den Interaktiven WebAssembly-Rendermodus für die App.
Die App-Einstellungsdateien (appsettings.Development.json, appsettings.json) im Server- oder .Client-Projekt stellen Konfigurationseinstellungen bereit. Im Serverprojekt befinden sich die Einstellungsdateien im Stammverzeichnis des Projekts. Im Projekt .Client werden Einstellungsdateien aus dem Ordner Webstamm, wwwroot, verwendet.
Im .Client-Projekt:
Der Ordner
Pagesenthält routingfähige clientseitige Razor Komponenten. Die Route für jede Seite wird mithilfe der@page-Anweisung angegeben.Der
wwwroot-Ordner ist der Webstamm-Ordner für das.Client-Projekt, der die öffentlichen statischen Assets der App enthält.Die
Program.cs-Datei ist der Einstiegspunkt des Projekts, der den WebAssembly-Host einrichtet und die Startlogik des Projekts enthält, einschließlich der Dienstregistrierungen, der Konfiguration, der Protokollierung und der Pipeline für die Anfrageverarbeitung.
Zusätzliche Dateien und Ordner können in einer App angezeigt werden, die aus einer Blazor Web App-Projektvorlage erstellt wurde, wenn zusätzliche Optionen konfiguriert sind. Beispielsweise umfasst das Erstellen einer App mit ASP.NET Core Identity zusätzliche Ressourcen zur Authentifizierung und Autorisierung.
Blazor Server
Blazor Server Projektvorlagen: blazorserver, blazorserver-empty
Die Blazor Server-Vorlage erstellt die anfänglichen Dateien und die Verzeichnisstruktur für eine Blazor Server-App:
- Wenn die Vorlage
blazorserververwendet wird, wird die App mit Folgendem aufgefüllt:- Demonstrationscode für eine
FetchData-Komponente, die Daten eines Wettervorhersagediensts (WeatherForecastService) lädt, und die Interaktion des Benutzers mit einerCounter-Komponente. - Bootstrap-Frontend-Toolkit.
- Demonstrationscode für eine
- Bei Verwendung der Vorlage
blazorserver-emptywird die App ohne Demonstrationscode und Bootstrap erstellt.
Projektstruktur:
Datafolder: Enthält dieWeatherForecastKlasse und Implementierung derWeatherForecastService, die Beispielwetterdaten für die App-KomponenteFetchDatabereitstellt.Pagesordner: Enthält die Blazor routingfähigen Razor Komponenten der App (.razor) und die Stammseite Razor einer Blazor Server App. Die Route für jede Seite wird mithilfe der@page-Anweisung angegeben. Die Vorlage besteht aus den folgenden Teilen:-
_Host.cshtml: Die Stammseite der App, implementiert als Razor Page:- Wenn eine Seite der App zum ersten Mal angefordert wird, wird diese Seite gerendert und in der Antwort zurückgegeben.
- Die Hostseite gibt an, wo die
App-Stammkomponente (App.razor) gerendert wird.
-
Countercomponent (Counter.razor): Implementiert die Seite „Counter“. -
Errorcomponent (Error.razor): Wird gerendert, wenn eine unbehandelte Ausnahme in der App auftritt. -
FetchData-Komponente (FetchData.razor): Implementiert die Seite „Daten abrufen“. -
IndexKomponente (Index.razor): Implementiert die Home-Seite.
-
Propertiesfolder: Enthält die Entwicklungsumgebungskonfiguration in derlaunchSettings.jsonDatei.Hinweis
Wenn eine App mit der .NET CLI ausgeführt wird, wird standardmäßig das erste Startprofil in
launchSettings.jsonverwendet, dessencommandNamegleichProjectist. Um ein anderes Profil (z. B.https) zu verwenden, geben Sie die Option-lp|--launch-profileandotnet watchoderdotnet runweiter, oder verschieben Sie das bevorzugte Profil an den Anfang der Datei.Sharedordner: Enthält die folgenden freigegebenen Komponenten und Stylesheets:-
MainLayoutComponent (MainLayout.razor): Die Layoutkomponente der App. -
MainLayout.razor.css: Stylesheet für das Hauptlayout der App. -
NavMenuKomponente (NavMenu.razor): Implementiert die Seitenleistennavigation. Sie schließt dieNavLink-Komponente (NavLink) ein, die Navigationslinks zu anderen Razor-Komponenten rendert. Die NavLink-Komponente gibt automatisch einen ausgewählten Zustand an, wenn die Komponente geladen wird, sodass der Benutzer nachvollziehen kann, welche Komponente derzeit angezeigt wird. -
NavMenu.razor.css: Stylesheet für das Navigationsmenü der App. -
SurveyPromptKomponente (SurveyPrompt.razor): Blazor Umfragekomponente.
-
wwwrootordner: Der Webstammordner für die App, die die öffentlichen statischen Ressourcen der App enthält._Imports.razor: Enthält allgemeine Razor Direktiven, die in die Komponenten der App aufgenommen werden sollen (.razor), wie z. B.@usingDirektiven für Namespaces.App.razor: Die Stammkomponente der App, die clientseitiges Routing mithilfe der Router Komponente einrichtet. Die Router-Komponente fängt die Browsernavigation ab und rendert die Seite, die der angeforderten Adresse entspricht.appsettings.jsonund Dateien mit den Umgebungseinstellungen der App: Geben Sie Konfigurationseinstellungen für die App an.Program.cs: Der Einstiegspunkt der App, der den ASP.NET Core Host einrichtet und die Startlogik der App enthält, einschließlich Dienstregistrierungen und Anforderungsverarbeitungspipelinekonfiguration:- Hiermit werden die DI-Dienste (Dependency Injection) der App angegeben. Dienste werden durch Aufruf von AddServerSideBlazor hinzugefügt, und
WeatherForecastServicewird dem Dienstcontainer hinzugefügt, damit dieFetchData-Beispielkomponente darauf zugreifen kann. - Konfiguriert die Pipeline für die Anforderungsverarbeitung der App:
- MapBlazorHub wird aufgerufen, um einen Endpunkt für die Echtzeitverbindung mit dem Browser einzurichten. Die Verbindung wird mit SignalR hergestellt. Dabei handelt es sich um ein Framework zum Hinzufügen von Echtzeitwebfunktionen zu Apps.
-
MapFallbackToPage("/_Host")wird aufgerufen, um die Stammseite der App (Pages/_Host.cshtml) einzurichten und die Navigation zu aktivieren.
- Hiermit werden die DI-Dienste (Dependency Injection) der App angegeben. Dienste werden durch Aufruf von AddServerSideBlazor hinzugefügt, und
Zusätzliche Dateien und Ordner können in einer App angezeigt werden, die aus einer Blazor Server-Projektvorlage erstellt wurde, wenn zusätzliche Optionen konfiguriert sind. Beispielsweise umfasst das Erstellen einer App mit ASP.NET Core Identity zusätzliche Ressourcen zur Authentifizierung und Autorisierung.
Blazor Server Projektvorlage: blazorserver
Die Blazor Server-Vorlage erstellt die anfänglichen Dateien und die Verzeichnisstruktur für eine Blazor Server-App. Die App wird mit Demonstrationscode für eine FetchData-Komponente, die Daten aus dem registrierten Dienst WeatherForecastService lädt, und für die Benutzerinteraktion mit einer Counter-Komponente aufgefüllt.
Datafolder: Enthält dieWeatherForecastKlasse und Implementierung derWeatherForecastService, die Beispielwetterdaten für die App-KomponenteFetchDatabereitstellt.Pagesordner: Enthält die Blazor routingfähigen Razor Komponenten der App (.razor) und die Stammseite Razor einer Blazor Server App. Die Route für jede Seite wird mithilfe der@page-Anweisung angegeben. Die Vorlage besteht aus den folgenden Teilen:-
_Host.cshtml: Die Hauptseite der App, die als Razor Page implementiert ist:- Wenn eine Seite der App zum ersten Mal angefordert wird, wird diese Seite gerendert und in der Antwort zurückgegeben.
- Die Hostseite gibt an, wo die
App-Stammkomponente (App.razor) gerendert wird.
-
_Layout.cshtml: Die Layoutseite für die_Host.cshtmlRoot-Seite der App. -
Countercomponent (Counter.razor): Implementiert die Counter-Seite. -
Errorcomponent (Error.razor): Wird angezeigt, wenn eine unbehandelte Ausnahme in der App auftritt. -
FetchDatacomponent (FetchData.razor): Implementiert die Seite „Fetch data“. -
Indexcomponent (Index.razor): Implementiert die Home Seite.
-
Propertiesfolder: Enthält die Entwicklungsumgebungskonfiguration in derlaunchSettings.jsonDatei.Hinweis
Wenn eine App mit der .NET CLI ausgeführt wird, wird standardmäßig das erste Startprofil in
launchSettings.jsonverwendet, dessencommandNamegleichProjectist. Um ein anderes Profil (z. B.https) zu verwenden, geben Sie die Option-lp|--launch-profileandotnet watchoderdotnet runweiter, oder verschieben Sie das bevorzugte Profil an den Anfang der Datei.SharedOrdner: Enthält die folgenden freigegebenen Komponenten und Stylesheets:-
MainLayoutComponent (MainLayout.razor): Die Layoutkomponente der App. -
MainLayout.razor.css: Stylesheet für das Hauptlayout der App. -
NavMenucomponent (NavMenu.razor): Implements sidebar navigation. Sie schließt dieNavLink-Komponente (NavLink) ein, die Navigationslinks zu anderen Razor-Komponenten rendert. Die NavLink-Komponente gibt automatisch einen ausgewählten Zustand an, wenn die Komponente geladen wird, sodass der Benutzer nachvollziehen kann, welche Komponente derzeit angezeigt wird. -
NavMenu.razor.css: Stylesheet für das Navigationsmenü der App. -
SurveyPromptKomponente (SurveyPrompt.razor): Blazor Umfragekomponente.
-
wwwrootOrdner: Der Webstammordner der App, der die öffentlichen statischen Ressourcen der App enthält._Imports.razor: Enthält allgemeine Razor-Direktiven, die in die Komponenten der App aufgenommen werden sollen (.razor), wie@using-Direktiven für Namespaces.App.razor: Die Stammkomponente der App, die clientseitiges Routing mithilfe der Router Komponente einrichtet. Die Router-Komponente fängt die Browsernavigation ab und rendert die Seite, die der angeforderten Adresse entspricht.appsettings.jsonund Dateien mit den Umgebungseinstellungen der App: Geben Sie Konfigurationseinstellungen für die App an.Program.cs: Der Einstiegspunkt der App, der den ASP.NET Core Host einrichtet und die Startlogik der App enthält, einschließlich Dienstregistrierungen und Anforderungsverarbeitungspipelinekonfiguration:- Hiermit werden die DI-Dienste (Dependency Injection) der App angegeben. Dienste werden durch Aufruf von AddServerSideBlazor hinzugefügt, und
WeatherForecastServicewird dem Dienstcontainer hinzugefügt, damit dieFetchData-Beispielkomponente darauf zugreifen kann. - Konfiguriert die Pipeline für die Anforderungsverarbeitung der App:
- MapBlazorHub wird aufgerufen, um einen Endpunkt für die Echtzeitverbindung mit dem Browser einzurichten. Die Verbindung wird mit SignalR hergestellt. Dabei handelt es sich um ein Framework zum Hinzufügen von Echtzeitwebfunktionen zu Apps.
-
MapFallbackToPage("/_Host")wird aufgerufen, um die Stammseite der App (Pages/_Host.cshtml) einzurichten und die Navigation zu aktivieren.
- Hiermit werden die DI-Dienste (Dependency Injection) der App angegeben. Dienste werden durch Aufruf von AddServerSideBlazor hinzugefügt, und
Zusätzliche Dateien und Ordner können in einer App angezeigt werden, die aus einer Blazor Server-Projektvorlage erstellt wurde, wenn zusätzliche Optionen konfiguriert sind. Beispielsweise umfasst das Erstellen einer App mit ASP.NET Core Identity zusätzliche Ressourcen zur Authentifizierung und Autorisierung.
Blazor Server Projektvorlage: blazorserver
Die Blazor Server-Vorlage erstellt die anfänglichen Dateien und die Verzeichnisstruktur für eine Blazor Server-App. Die App wird mit Demonstrationscode für eine FetchData-Komponente, die Daten aus dem registrierten Dienst WeatherForecastService lädt, und für die Benutzerinteraktion mit einer Counter-Komponente aufgefüllt.
Datafolder: Enthält dieWeatherForecastKlasse und Implementierung derWeatherForecastService, die Beispielwetterdaten für die App-KomponenteFetchDatabereitstellt.Pagesordner: Enthält die Blazor routingfähigen Razor Komponenten der App (.razor) und die Stammseite Razor einer Blazor Server App. Die Route für jede Seite wird mithilfe der@page-Anweisung angegeben. Die Vorlage besteht aus den folgenden Teilen:-
_Host.cshtml: Die Stammseite der App, die als Razor Page implementiert ist:- Wenn eine Seite der App zum ersten Mal angefordert wird, wird diese Seite gerendert und in der Antwort zurückgegeben.
- Die Hostseite gibt an, wo die
App-Stammkomponente (App.razor) gerendert wird.
-
Countercomponent (Counter.razor): Implements the Counter page. -
Errorcomponent (Error.razor): Wird gerendert, wenn eine unbehandelte Ausnahme in der App auftritt. -
FetchDatacomponent (FetchData.razor): Implementiert die Seite „Fetch data“. -
IndexKomponente (Index.razor): Implementiert die Home Seite.
-
Propertiesfolder: Enthält die Entwicklungsumgebungskonfiguration in derlaunchSettings.jsonDatei.Hinweis
Wenn eine App mit der .NET CLI ausgeführt wird, wird standardmäßig das erste Startprofil in
launchSettings.jsonverwendet, dessencommandNamegleichProjectist. Um ein anderes Profil (z. B.https) zu verwenden, geben Sie die Option-lp|--launch-profileandotnet watchoderdotnet runweiter, oder verschieben Sie das bevorzugte Profil an den Anfang der Datei.Sharedordner: Enthält die folgenden freigegebenen Komponenten und Stylesheets:-
MainLayoutComponent (MainLayout.razor): Die Layoutkomponente der App. -
MainLayout.razor.css: Stylesheet für das Hauptlayout der App. -
NavMenu-Komponente (NavMenu.razor): Implementiert die Sidebar-Navigation. Sie schließt dieNavLink-Komponente (NavLink) ein, die Navigationslinks zu anderen Razor-Komponenten rendert. Die NavLink-Komponente gibt automatisch einen ausgewählten Zustand an, wenn die Komponente geladen wird, sodass der Benutzer nachvollziehen kann, welche Komponente derzeit angezeigt wird. -
NavMenu.razor.css: Stylesheet für das Navigationsmenü der App. -
SurveyPromptKomponente (SurveyPrompt.razor): Blazor Umfragekomponente.
-
wwwrootordner: Der Webstammordner für die App, die die öffentlichen statischen Ressourcen der App enthält._Imports.razor: Enthält allgemeine Razor Direktiven, die in die Komponenten der App aufgenommen werden sollen (.razor), z. B.@using-Direktiven für Namespaces.App.razor: Die Stammkomponente der App, die clientseitiges Routing mithilfe der Router Komponente einrichtet. Die Router-Komponente fängt die Browsernavigation ab und rendert die Seite, die der angeforderten Adresse entspricht.appsettings.jsonund Umgebungs-App-Einstellungsdateien: stellen Konfigurationseinstellungen für die App bereit.Program.cs: Der Einstiegspunkt der App, der den ASP.NET Core Host einrichtet.Startup.cs: Enthält die Startlogik der App. DieStartup-Klasse definiert zwei Methoden:-
ConfigureServices: Konfiguriert die Abhängigkeitsinjektionsdienste (Dependency Injection, DI) der App. Dienste werden durch Aufruf von AddServerSideBlazor hinzugefügt, undWeatherForecastServicewird dem Dienstcontainer hinzugefügt, damit dieFetchData-Beispielkomponente darauf zugreifen kann. -
Configure: Konfiguriert die Anforderungsbehandlungspipeline der App:- MapBlazorHub wird aufgerufen, um einen Endpunkt für die Echtzeitverbindung mit dem Browser einzurichten. Die Verbindung wird mit SignalR hergestellt. Dabei handelt es sich um ein Framework zum Hinzufügen von Echtzeitwebfunktionen zu Apps.
-
MapFallbackToPage("/_Host")wird aufgerufen, um die Stammseite der App (Pages/_Host.cshtml) einzurichten und die Navigation zu aktivieren.
-
Zusätzliche Dateien und Ordner können in einer App angezeigt werden, die aus einer Blazor Server-Projektvorlage erstellt wurde, wenn zusätzliche Optionen konfiguriert sind. Beispielsweise umfasst das Erstellen einer App mit ASP.NET Core Identity zusätzliche Ressourcen zur Authentifizierung und Autorisierung.
Blazor Server Projektvorlage: blazorserver
Die Blazor Server-Vorlage erstellt die anfänglichen Dateien und die Verzeichnisstruktur für eine Blazor Server-App. Die App wird mit Demonstrationscode für eine FetchData-Komponente, die Daten aus dem registrierten Dienst WeatherForecastService lädt, und für die Benutzerinteraktion mit einer Counter-Komponente aufgefüllt.
Datafolder: Enthält dieWeatherForecastKlasse und Implementierung derWeatherForecastService, die Beispielwetterdaten für die App-KomponenteFetchDatabereitstellt.Pagesordner: Enthält die Blazor routingfähigen Razor Komponenten der App (.razor) und die Stammseite Razor einer Blazor Server App. Die Route für jede Seite wird mithilfe der@page-Anweisung angegeben. Die Vorlage besteht aus den folgenden Teilen:-
_Host.cshtml: Die Stammseite der App, implementiert als Razor Page:- Wenn eine Seite der App zum ersten Mal angefordert wird, wird diese Seite gerendert und in der Antwort zurückgegeben.
- Die Hostseite gibt an, wo die
App-Stammkomponente (App.razor) gerendert wird.
-
Countercomponent (Counter.razor): Implementiert die Seite „Counter“. -
Errorcomponent (Error.razor): Wird gerendert, wenn eine unbehandelte Ausnahme in der App auftritt. -
FetchData-Komponente (FetchData.razor): Implementiert die Seite „Daten abrufen“. -
Index-Komponente (Index.razor): Implementiert die Seite Home.
-
PropertiesOrdner: Enthält die Entwicklungsumgebungskonfiguration in derlaunchSettings.jsonDatei.Hinweis
Wenn eine App mit der .NET CLI ausgeführt wird, wird standardmäßig das erste Startprofil in
launchSettings.jsonverwendet, dessencommandNamegleichProjectist. Um ein anderes Profil (z. B.https) zu verwenden, geben Sie die Option-lp|--launch-profileandotnet watchoderdotnet runweiter, oder verschieben Sie das bevorzugte Profil an den Anfang der Datei.Sharedordner: Enthält die folgenden freigegebenen Komponenten:-
MainLayoutComponent (MainLayout.razor): Die Layoutkomponente der App. -
NavMenucomponent (NavMenu.razor): Implementiert die Seitenleistennavigation. Sie schließt dieNavLink-Komponente (NavLink) ein, die Navigationslinks zu anderen Razor-Komponenten rendert. Die NavLink-Komponente gibt automatisch einen ausgewählten Zustand an, wenn die Komponente geladen wird, sodass der Benutzer nachvollziehen kann, welche Komponente derzeit angezeigt wird. -
SurveyPromptKomponente (SurveyPrompt.razor): Blazor Umfragekomponente.
-
wwwrootOrdner: Der Webstammordner für die App, der die öffentlichen statischen Ressourcen der App enthält._Imports.razor: Enthält allgemeine Razor-Direktiven, die in die Komponenten der App aufgenommen werden sollen (.razor), z. B.@using-Direktiven für Namespaces.App.razor: Die Stammkomponente der App, die clientseitiges Routing mithilfe der Router Komponente einrichtet. Die Router-Komponente fängt die Browsernavigation ab und rendert die Seite, die der angeforderten Adresse entspricht.appsettings.jsonund Dateien mit den Umgebungseinstellungen der App: Geben Sie Konfigurationseinstellungen für die App an.Program.cs: Der Einstiegspunkt der App, der den ASP.NET Core Host einrichtet.Startup.cs: Enthält die Startlogik der App. DieStartup-Klasse definiert zwei Methoden:-
ConfigureServices: Konfiguriert die Abhängigkeitsinjektionsdienste (Dependency Injection, DI) der App. Dienste werden durch Aufruf von AddServerSideBlazor hinzugefügt, undWeatherForecastServicewird dem Dienstcontainer hinzugefügt, damit dieFetchData-Beispielkomponente darauf zugreifen kann. -
Configure: Konfiguriert die Anforderungsbehandlungspipeline der App:- MapBlazorHub wird aufgerufen, um einen Endpunkt für die Echtzeitverbindung mit dem Browser einzurichten. Die Verbindung wird mit SignalR hergestellt. Dabei handelt es sich um ein Framework zum Hinzufügen von Echtzeitwebfunktionen zu Apps.
-
MapFallbackToPage("/_Host")wird aufgerufen, um die Stammseite der App (Pages/_Host.cshtml) einzurichten und die Navigation zu aktivieren.
-
Zusätzliche Dateien und Ordner können in einer App angezeigt werden, die aus einer Blazor Server-Projektvorlage erstellt wurde, wenn zusätzliche Optionen konfiguriert sind. Beispielsweise umfasst das Erstellen einer App mit ASP.NET Core Identity zusätzliche Ressourcen zur Authentifizierung und Autorisierung.
Eigenständige Blazor WebAssembly-App
Eigenständige Blazor WebAssembly-Projektvorlage: blazorwasm
Die Blazor WebAssembly-Vorlage erstellt die anfänglichen Dateien und die Verzeichnisstruktur für eine eigenständige Blazor WebAssembly-App:
- Wenn die Vorlage
blazorwasmverwendet wird, wird die App mit Folgendem aufgefüllt:- Demonstrationscode für eine
Weather-Komponente, die Daten aus der statischen Ressourceweather.jsonlädt, und für die Benutzerinteraktion mit einerCounter-Komponente. - Bootstrap-Frontend-Toolkit.
- Demonstrationscode für eine
- Die
blazorwasm-Vorlage kann auch ohne Beispielseiten und Formatierung generiert werden.
Projektstruktur:
-
Layoutordner: Enthält die folgenden Layoutkomponenten und Stylesheets:-
MainLayoutComponent (MainLayout.razor): Die Layoutkomponente der App. -
MainLayout.razor.css: Stylesheet für das Hauptlayout der App. -
NavMenuKomponente (NavMenu.razor): Implementiert die Seitenleistennavigation. Sie schließt dieNavLink-Komponente (NavLink) ein, die Navigationslinks zu anderen Razor-Komponenten rendert. Die NavLink-Komponente gibt automatisch einen ausgewählten Zustand an, wenn die Komponente geladen wird, sodass der Benutzer nachvollziehen kann, welche Komponente derzeit angezeigt wird. -
NavMenu.razor.css: Stylesheet für das Navigationsmenü der App.
-
- Ordner
Pages: Enthält die routingfähigen Razor-Komponenten der Blazor-App (.razor). Die Route für jede Seite wird mithilfe der@page-Anweisung angegeben. Die Vorlage enthält die folgenden Komponenten:-
Countercomponent (Counter.razor): Implements the Counter page. -
Indexcomponent (Index.razor): Implements the Home page. -
Weathercomponent (Weather.razor): Implementiert die Weather-Seite. -
NotFoundcomponent (NotFound.razor): Implements a Not Found page to display when content isn't found for a request path. Weitere Informationen finden Sie unter ASP.NET Core-NavigationBlazor.
-
- Ordner
Pages: Enthält die routingfähigen Razor-Komponenten der Blazor-App (.razor). Die Route für jede Seite wird mithilfe der@page-Anweisung angegeben. Die Vorlage enthält die folgenden Komponenten:-
Countercomponent (Counter.razor): Implementiert die Counter-Seite. -
Indexcomponent (Index.razor): Implements the Home page. -
Weather-Komponente (Weather.razor): Implementiert die Wetterseite.
-
_Imports.razor: Enthält allgemeine Razor-Direktiven, die in die Komponenten der App aufgenommen werden sollen (.razor), z. B.@using-Direktiven für Namespaces.App.razor: Die Stammkomponente der App, die clientseitiges Routing mithilfe der Router Komponente einrichtet. Die Router-Komponente fängt die Browsernavigation ab und rendert die Seite, die der angeforderten Adresse entspricht.Propertiesfolder: Enthält die Entwicklungsumgebungskonfiguration in derlaunchSettings.jsonDatei.Hinweis
Wenn eine App mit der .NET CLI ausgeführt wird, wird standardmäßig das erste Startprofil in
launchSettings.jsonverwendet, dessencommandNamegleichProjectist. Um ein anderes Profil (z. B.https) zu verwenden, geben Sie die Option-lp|--launch-profileandotnet watchoderdotnet runweiter, oder verschieben Sie das bevorzugte Profil an den Anfang der Datei.wwwrootOrdner: Der Webstammverzeichnis-Ordner für die App, der die öffentlichen statischen Ressourcen der App enthält, einschließlichappsettings.jsonund Umgebungseinstellungsdateien der App für Konfigurationseinstellungen und Beispielwetterdaten (sample-data/weather.json). Die Webseiteindex.htmlist die Stammseite der App, die als HTML-Seite implementiert ist:- Wenn eine Seite der App zum ersten Mal angefordert wird, wird diese Seite gerendert und in der Antwort zurückgegeben.
- Die Seite gibt an, wo die
App-Stammkomponente gerendert wird. Die Komponente wird an der Position desdiv-DOM-Elements mit einemid-Objekt vonapp(<div id="app">Loading...</div>) gerendert.
Program.cs: Der Einstiegspunkt der App, der den WebAssembly-Host einrichtet:- Die
App-Komponente ist die Stammkomponente der App. DieApp-Komponente wird als dasdiv-DOM-Element mit einemid-Objekt vonapp(<div id="app">Loading...</div>inwwwroot/index.html) für die Stammkomponentensammlung (builder.RootComponents.Add<App>("#app")) angegeben. -
Dienste werden hinzugefügt und konfiguriert (z. B
builder.Services.AddSingleton<IMyDependency, MyDependency>(). ).
- Die
Zusätzliche Dateien und Ordner können in einer App angezeigt werden, die aus einer Blazor WebAssembly-Projektvorlage erstellt wurde, wenn zusätzliche Optionen konfiguriert sind. Beispielsweise umfasst das Erstellen einer App mit ASP.NET Core Identity zusätzliche Ressourcen zur Authentifizierung und Autorisierung.
Blazor WebAssembly
Blazor WebAssembly Projektvorlagen: blazorwasm, blazorwasm-empty
Die Blazor WebAssembly-Vorlage erstellt die anfänglichen Dateien und die Verzeichnisstruktur für eine Blazor WebAssembly-App:
- Wenn die Vorlage
blazorwasmverwendet wird, wird die App mit Folgendem aufgefüllt:- Demonstrationscode für eine
FetchData-Komponente, die Daten aus der statischen Ressourceweather.jsonlädt, und für die Benutzerinteraktion mit einerCounter-Komponente. - Bootstrap für das Front-End-Toolkit.
- Demonstrationscode für eine
- Bei Verwendung der Vorlage
blazorwasm-emptywird die App ohne Demonstrationscode und Bootstrap erstellt.
Projektstruktur:
Pagesfolder: Enthält die routingfähigen.razorKomponenten der Blazor App (Razor). Die Route für jede Seite wird mithilfe der@page-Anweisung angegeben. Die Vorlage besteht aus den folgenden Komponenten:-
Countercomponent (Counter.razor): Implementiert die Counter-Seite. -
FetchDatacomponent (FetchData.razor): Implementiert die Seite „Fetch data“. -
IndexKomponente (Index.razor): Implementiert die Seite Home.
-
PropertiesOrdner: Enthält die Entwicklungsumgebungskonfiguration in derlaunchSettings.json-Datei.Hinweis
Wenn eine App mit der .NET CLI ausgeführt wird, wird standardmäßig das erste Startprofil in
launchSettings.jsonverwendet, dessencommandNamegleichProjectist. Um ein anderes Profil (z. B.https) zu verwenden, geben Sie die Option-lp|--launch-profileandotnet watchoderdotnet runweiter, oder verschieben Sie das bevorzugte Profil an den Anfang der Datei.Sharedordner: Enthält die folgenden freigegebenen Komponenten und Stylesheets:-
MainLayoutComponent (MainLayout.razor): Die Layoutkomponente der App. -
MainLayout.razor.css: Stylesheet für das Hauptlayout der App. -
NavMenucomponent (NavMenu.razor): Implements sidebar navigation. Sie schließt dieNavLink-Komponente (NavLink) ein, die Navigationslinks zu anderen Razor-Komponenten rendert. Die NavLink-Komponente gibt automatisch einen ausgewählten Zustand an, wenn die Komponente geladen wird, sodass der Benutzer nachvollziehen kann, welche Komponente derzeit angezeigt wird. -
NavMenu.razor.css: Stylesheet für das Navigationsmenü der App. -
SurveyPromptKomponente (SurveyPrompt.razor) (ASP.NET Core in .NET 7 oder früher): Blazor Umfragekomponente.
-
wwwrootordner: Der Webstammordner für die App, der die öffentlichen statischen Ressourcen der App enthält, einschließlichappsettings.jsonund Umgebungs-App-Einstellungsdateien für Konfigurationseinstellungen. Die Webseiteindex.htmlist die Stammseite der App, die als HTML-Seite implementiert ist:- Wenn eine Seite der App zum ersten Mal angefordert wird, wird diese Seite gerendert und in der Antwort zurückgegeben.
- Die Seite gibt an, wo die
App-Stammkomponente gerendert wird. Die Komponente wird an der Position desdiv-DOM-Elements mit einemid-Objekt vonapp(<div id="app">Loading...</div>) gerendert.
_Imports.razor: Enthält allgemeine Razor Direktiven, die in die Komponenten der App aufgenommen werden sollen (.razor), z. B.@using-Direktiven für Namespaces.App.razor: Die Stammkomponente der App, die clientseitiges Routing mithilfe der Router Komponente einrichtet. Die Router-Komponente fängt die Browsernavigation ab und rendert die Seite, die der angeforderten Adresse entspricht.Program.cs: Der Einstiegspunkt der App, der den WebAssembly-Host einrichtet:- Die
App-Komponente ist die Stammkomponente der App. DieApp-Komponente wird als dasdiv-DOM-Element mit einemid-Objekt vonapp(<div id="app">Loading...</div>inwwwroot/index.html) für die Stammkomponentensammlung (builder.RootComponents.Add<App>("#app")) angegeben. -
Dienste werden hinzugefügt und konfiguriert (z. B
builder.Services.AddSingleton<IMyDependency, MyDependency>(). ).
- Die
Zusätzliche Dateien und Ordner können in einer App angezeigt werden, die aus einer Blazor WebAssembly-Projektvorlage erstellt wurde, wenn zusätzliche Optionen konfiguriert sind. Beispielsweise umfasst das Erstellen einer App mit ASP.NET Core Identity zusätzliche Ressourcen zur Authentifizierung und Autorisierung.
Eine gehostete Blazor WebAssembly Lösung umfasst die folgenden ASP.NET Core-Projekte:
- Client: Die Blazor WebAssembly-App.
- Server: Eine App, die die Blazor WebAssembly-App und Wetterdaten für Clients bereitstellt.
- Shared: Ein Projekt, das allgemeine Klassen, Methoden und Ressourcen verwaltet.
Die Lösung wird aus der Blazor WebAssembly-Projektvorlage in Visual Studio mit aktiviertem Kontrollkästchen ASP.NET Core Hosted oder mit der Option -ho|--hosted mithilfe des dotnet new blazorwasm-Befehls der .NET-CLI erstellt. Weitere Informationen finden Sie unter Tooling for ASP.NET Core Blazor.
Die Projektstruktur der clientseitigen App in einer gehosteten Blazor WebAssembly-Projektmappe (Projekt „Client“) entspricht der Projektstruktur für eine eigenständige Blazor WebAssembly-App. Zusätzliche Dateien in einer gehosteten Blazor WebAssembly-Lösung:
- Das Projekt „Server“ umfasst einen Wettervorhersagecontroller unter
Controllers/WeatherForecastController.cs, der Wetterdaten an die Client-Komponente des Projekts „FetchData“ zurückgibt. - Das Projekt „Shared“ enthält eine Wettervorhersageklasse unter
WeatherForecast.cs, die Wetterdaten für die Projekte „Client“ und „Server“ darstellt.
Blazor WebAssembly
Blazor WebAssembly Projektvorlage: blazorwasm
Die Blazor WebAssembly-Vorlage erstellt die anfänglichen Dateien und die Verzeichnisstruktur für eine Blazor WebAssembly-App. Die App wird mit Demonstrationscode für eine FetchData-Komponente, die Daten aus der statischen Ressource weather.json lädt, und für die Benutzerinteraktion mit einer Counter-Komponente aufgefüllt.
Ordner
Pages: Enthält die routingfähigen Razor-Komponenten der Blazor-App (.razor). Die Route für jede Seite wird mithilfe der@page-Anweisung angegeben. Die Vorlage besteht aus den folgenden Komponenten:-
CounterKomponente (Counter.razor): Implementiert die Counter-Seite. -
FetchDatacomponent (FetchData.razor): Implementiert die Seite „Daten abrufen“. -
Indexcomponent (Index.razor): Implementiert die Seite Home.
-
Propertiesfolder: Enthält die Entwicklungsumgebungskonfiguration in derlaunchSettings.jsonDatei.Hinweis
Wenn eine App mit der .NET CLI ausgeführt wird, wird standardmäßig das erste Startprofil in
launchSettings.jsonverwendet, dessencommandNamegleichProjectist. Um ein anderes Profil (z. B.https) zu verwenden, geben Sie die Option-lp|--launch-profileandotnet watchoderdotnet runweiter, oder verschieben Sie das bevorzugte Profil an den Anfang der Datei.Sharedordner: Enthält die folgenden freigegebenen Komponenten und Stylesheets:-
MainLayoutComponent (MainLayout.razor): Die Layoutkomponente der App. -
MainLayout.razor.css: Stylesheet für das Hauptlayout der App. -
NavMenuKomponente (NavMenu.razor): Implementiert die Seitenleistennavigation. Sie schließt dieNavLink-Komponente (NavLink) ein, die Navigationslinks zu anderen Razor-Komponenten rendert. Die NavLink-Komponente gibt automatisch einen ausgewählten Zustand an, wenn die Komponente geladen wird, sodass der Benutzer nachvollziehen kann, welche Komponente derzeit angezeigt wird. -
NavMenu.razor.css: Stylesheet für das Navigationsmenü der App. -
SurveyPrompt-Komponente (SurveyPrompt.razor): Blazor-Umfragekomponente.
-
wwwrootOrdner: Der Webstammordner für die App, der die öffentlichen statischen Ressourcen der App enthält, einschließlichappsettings.jsonund Umgebungs-App-Einstellungsdateien für Konfiguration. Die Webseiteindex.htmlist die Stammseite der App, die als HTML-Seite implementiert ist:- Wenn eine Seite der App zum ersten Mal angefordert wird, wird diese Seite gerendert und in der Antwort zurückgegeben.
- Die Seite gibt an, wo die
App-Stammkomponente gerendert wird. Die Komponente wird an der Position desdiv-DOM-Elements mit einemid-Objekt vonapp(<div id="app">Loading...</div>) gerendert.
_Imports.razor: Enthält allgemeine Razor-Direktiven, die in die Komponenten der App aufgenommen werden sollen (.razorz. B.@using-Direktiven für Namespaces).App.razor: Die Stammkomponente der App, die clientseitiges Routing mithilfe der Komponente Router einrichtet. Die Router-Komponente fängt die Browsernavigation ab und rendert die Seite, die der angeforderten Adresse entspricht.Program.cs: Der Einstiegspunkt der App, der den WebAssembly-Host einrichtet:- Die
App-Komponente ist die Stammkomponente der App. DieApp-Komponente wird als dasdiv-DOM-Element mit einemid-Objekt vonapp(<div id="app">Loading...</div>inwwwroot/index.html) für die Stammkomponentensammlung (builder.RootComponents.Add<App>("#app")) angegeben. -
Dienste werden hinzugefügt und konfiguriert (z. B.
builder.Services.AddSingleton<IMyDependency, MyDependency>()).
- Die
Zusätzliche Dateien und Ordner können in einer App angezeigt werden, die aus einer Blazor WebAssembly-Projektvorlage erstellt wurde, wenn zusätzliche Optionen konfiguriert sind. Beispielsweise umfasst das Erstellen einer App mit ASP.NET Core Identity zusätzliche Ressourcen zur Authentifizierung und Autorisierung.
Eine gehostete Blazor WebAssembly Lösung umfasst die folgenden ASP.NET Core-Projekte:
- Client: Die Blazor WebAssembly-App.
- Server: Eine App, die die Blazor WebAssembly-App und Wetterdaten für Clients bereitstellt.
- Shared: Ein Projekt, das allgemeine Klassen, Methoden und Ressourcen verwaltet.
Die Lösung wird aus der Blazor WebAssembly-Projektvorlage in Visual Studio mit aktiviertem Kontrollkästchen ASP.NET Core Hosted oder mit der Option -ho|--hosted mithilfe des dotnet new blazorwasm-Befehls der .NET-CLI erstellt. Weitere Informationen finden Sie unter Tooling for ASP.NET Core Blazor.
Die Projektstruktur der clientseitigen App in einer gehosteten Blazor WebAssembly-Projektmappe (Projekt „Client“) entspricht der Projektstruktur für eine eigenständige Blazor WebAssembly-App. Zusätzliche Dateien in einer gehosteten Blazor WebAssembly-Lösung:
- Das Projekt „Server“ umfasst einen Wettervorhersagecontroller unter
Controllers/WeatherForecastController.cs, der Wetterdaten an die Client-Komponente des Projekts „FetchData“ zurückgibt. - Das Projekt „Shared“ enthält eine Wettervorhersageklasse unter
WeatherForecast.cs, die Wetterdaten für die Projekte „Client“ und „Server“ darstellt.
Blazor WebAssembly
Blazor WebAssembly Projektvorlage: blazorwasm
Die Blazor WebAssembly-Vorlage erstellt die anfänglichen Dateien und die Verzeichnisstruktur für eine Blazor WebAssembly-App. Die App wird mit Demonstrationscode für eine FetchData-Komponente, die Daten aus der statischen Ressource weather.json lädt, und für die Benutzerinteraktion mit einer Counter-Komponente aufgefüllt.
Ordner
Pages: Enthält die routingfähigen Razor-Komponenten der Blazor-App (.razor). Die Route für jede Seite wird mithilfe der@page-Anweisung angegeben. Die Vorlage besteht aus den folgenden Komponenten:-
Countercomponent (Counter.razor): Implements the Counter page. -
FetchDatacomponent (FetchData.razor): Implementiert die Seite „Fetch data“. -
Index-Komponente (Index.razor): Diese Komponente implementiert die Home-Seite.
-
Propertiesfolder: Enthält die Entwicklungsumgebungskonfiguration in derlaunchSettings.jsonDatei.Hinweis
Wenn eine App mit der .NET CLI ausgeführt wird, wird standardmäßig das erste Startprofil in
launchSettings.jsonverwendet, dessencommandNamegleichProjectist. Um ein anderes Profil (z. B.https) zu verwenden, geben Sie die Option-lp|--launch-profileandotnet watchoderdotnet runweiter, oder verschieben Sie das bevorzugte Profil an den Anfang der Datei.Sharedordner: Enthält die folgenden freigegebenen Komponenten und Stylesheets:-
MainLayoutKomponente (MainLayout.razor): Die Layoutkomponente der App. -
MainLayout.razor.css: Stylesheet für das Hauptlayout der App. -
NavMenucomponent (NavMenu.razor): Implements sidebar navigation. Sie schließt dieNavLink-Komponente (NavLink) ein, die Navigationslinks zu anderen Razor-Komponenten rendert. Die NavLink-Komponente gibt automatisch einen ausgewählten Zustand an, wenn die Komponente geladen wird, sodass der Benutzer nachvollziehen kann, welche Komponente derzeit angezeigt wird. -
NavMenu.razor.css: Stylesheet für das Navigationsmenü der App. -
SurveyPrompt-Komponente (SurveyPrompt.razor): Blazor-Umfragekomponente.
-
Ordner
wwwroot: Das Webstammverzeichnis für die App, das die öffentlichen statischen Ressourcen der App enthält, einschließlichappsettings.jsonund Dateien mit den Umgebungseinstellungen der App für Konfigurationseinstellungen. Die Webseiteindex.htmlist die Stammseite der App, die als HTML-Seite implementiert ist:- Wenn eine Seite der App zum ersten Mal angefordert wird, wird diese Seite gerendert und in der Antwort zurückgegeben.
- Die Seite gibt an, wo die
App-Stammkomponente gerendert wird. Die Komponente wird an der Position desdiv-DOM-Elements mit einemid-Objekt vonapp(<div id="app">Loading...</div>) gerendert.
_Imports.razor: Enthält gängige Razor-Anweisungen, die in die Komponenten der App (.razor) eingefügt werden sollen, z. B.@using-Anweisungen für Namespaces.App.razor: Hierbei handelt es sich um die Stammkomponente der App, die das clientseitige Routing mithilfe der Router-Komponente einrichtet. Die Router-Komponente fängt die Browsernavigation ab und rendert die Seite, die der angeforderten Adresse entspricht.Program.cs: Der Einstiegspunkt der App, der den WebAssembly-Host einrichtet:- Die
App-Komponente ist die Stammkomponente der App. DieApp-Komponente wird als dasdiv-DOM-Element mit einemid-Objekt vonapp(<div id="app">Loading...</div>inwwwroot/index.html) für die Stammkomponentensammlung (builder.RootComponents.Add<App>("#app")) angegeben. -
Dienste werden hinzugefügt und konfiguriert (z. B.
builder.Services.AddSingleton<IMyDependency, MyDependency>()).
- Die
Zusätzliche Dateien und Ordner können in einer App angezeigt werden, die aus einer Blazor WebAssembly-Projektvorlage erstellt wurde, wenn zusätzliche Optionen konfiguriert sind. Beispielsweise umfasst das Erstellen einer App mit ASP.NET Core Identity zusätzliche Ressourcen zur Authentifizierung und Autorisierung.
Eine gehostete Blazor WebAssembly Lösung umfasst die folgenden ASP.NET Core-Projekte:
- Client: Die Blazor WebAssembly-App.
- Server: Eine App, die die Blazor WebAssembly-App und Wetterdaten für Clients bereitstellt.
- Shared: Ein Projekt, das allgemeine Klassen, Methoden und Ressourcen verwaltet.
Die Lösung wird aus der Blazor WebAssembly-Projektvorlage in Visual Studio mit aktiviertem Kontrollkästchen ASP.NET Core Hosted oder mit der Option -ho|--hosted mithilfe des dotnet new blazorwasm-Befehls der .NET-CLI erstellt. Weitere Informationen finden Sie unter Tooling for ASP.NET Core Blazor.
Die Projektstruktur der clientseitigen App in einer gehosteten Blazor WebAssembly-Projektmappe (Projekt „Client“) entspricht der Projektstruktur für eine eigenständige Blazor WebAssembly-App. Zusätzliche Dateien in einer gehosteten Blazor WebAssembly-Lösung:
- Das Projekt „Server“ umfasst einen Wettervorhersagecontroller unter
Controllers/WeatherForecastController.cs, der Wetterdaten an die Client-Komponente des Projekts „FetchData“ zurückgibt. - Das Projekt „Shared“ enthält eine Wettervorhersageklasse unter
WeatherForecast.cs, die Wetterdaten für die Projekte „Client“ und „Server“ darstellt.
Blazor WebAssembly
Blazor WebAssembly Projektvorlage: blazorwasm
Die Blazor WebAssembly-Vorlage erstellt die anfänglichen Dateien und die Verzeichnisstruktur für eine Blazor WebAssembly-App. Die App wird mit Demonstrationscode für eine FetchData-Komponente, die Daten aus der statischen Ressource weather.json lädt, und für die Benutzerinteraktion mit einer Counter-Komponente aufgefüllt.
Ordner
Pages: Enthält die routingfähigen Razor-Komponenten der Blazor-App (.razor). Die Route für jede Seite wird mithilfe der@page-Anweisung angegeben. Die Vorlage besteht aus den folgenden Komponenten:-
CounterKomponente (Counter.razor): Implementiert die Seite „Counter“. -
FetchDataKomponente (FetchData.razor): Implementiert die Seite „Fetch data“. -
IndexKomponente (Index.razor): Implementiert die Home-Seite.
-
PropertiesOrdner: Enthält die Entwicklungsumgebungskonfiguration in derlaunchSettings.jsonDatei.Hinweis
Wenn eine App mit der .NET CLI ausgeführt wird, wird standardmäßig das erste Startprofil in
launchSettings.jsonverwendet, dessencommandNamegleichProjectist. Um ein anderes Profil (z. B.https) zu verwenden, geben Sie die Option-lp|--launch-profileandotnet watchoderdotnet runweiter, oder verschieben Sie das bevorzugte Profil an den Anfang der Datei.Sharedordner: Enthält die folgenden freigegebenen Komponenten:-
MainLayoutComponent (MainLayout.razor): Die Layoutkomponente der App. -
NavMenu-Komponente (NavMenu.razor): Diese Komponente implementiert die Navigation in der Seitenleiste. Sie schließt dieNavLink-Komponente (NavLink) ein, die Navigationslinks zu anderen Razor-Komponenten rendert. Die NavLink-Komponente gibt automatisch einen ausgewählten Zustand an, wenn die Komponente geladen wird, sodass der Benutzer nachvollziehen kann, welche Komponente derzeit angezeigt wird. -
SurveyPromptKomponente (SurveyPrompt.razor): Blazor Umfragekomponente.
-
wwwroot-Ordner: Der Web-Root-Ordner der App, der die öffentlich zugänglichen statischen Ressourcen der App enthält, einschließlichappsettings.jsonund Dateien mit App-Umgebungseinstellungen für Konfigurationseinstellungen. Die Webseiteindex.htmlist die Stammseite der App, die als HTML-Seite implementiert ist:- Wenn eine Seite der App zum ersten Mal angefordert wird, wird diese Seite gerendert und in der Antwort zurückgegeben.
- Die Seite gibt an, wo die
App-Stammkomponente gerendert wird. Die Komponente wird an der Position desapp-DOM-Elements (<app>Loading...</app>) gerendert.
_Imports.razor: Enthält allgemeine Razor Direktiven, die in die Komponenten der App aufgenommen werden sollen (.razor), z. B.@usingDirektiven für Namespaces.App.razor: Die Stammkomponente der App, die das clientseitige Routing mithilfe der Komponente Router einrichtet. Die Router-Komponente fängt die Browsernavigation ab und rendert die Seite, die der angeforderten Adresse entspricht.Program.cs: Der Einstiegspunkt der App, der den WebAssembly-Host einrichtet:- Die
App-Komponente ist die Stammkomponente der App. DieApp-Komponente wird als dasapp-DOM-Element (<app>Loading...</app>inwwwroot/index.html) für die Stammkomponentensammlung (builder.RootComponents.Add<App>("app")) angegeben. -
Dienste werden hinzugefügt und konfiguriert (z. B.
builder.Services.AddSingleton<IMyDependency, MyDependency>()).
- Die
Zusätzliche Dateien und Ordner können in einer App angezeigt werden, die aus einer Blazor WebAssembly-Projektvorlage erstellt wurde, wenn zusätzliche Optionen konfiguriert sind. Beispielsweise umfasst das Erstellen einer App mit ASP.NET Core Identity zusätzliche Ressourcen zur Authentifizierung und Autorisierung.
Eine gehostete Blazor WebAssembly Lösung umfasst die folgenden ASP.NET Core-Projekte:
- Client: Die Blazor WebAssembly-App.
- Server: Eine App, die die Blazor WebAssembly-App und Wetterdaten für Clients bereitstellt.
- Shared: Ein Projekt, das allgemeine Klassen, Methoden und Ressourcen verwaltet.
Die Lösung wird aus der Blazor WebAssembly-Projektvorlage in Visual Studio mit aktiviertem Kontrollkästchen ASP.NET Core Hosted oder mit der Option -ho|--hosted mithilfe des dotnet new blazorwasm-Befehls der .NET-CLI erstellt. Weitere Informationen finden Sie unter Tooling for ASP.NET Core Blazor.
Die Projektstruktur der clientseitigen App in einer gehosteten Blazor WebAssembly-Projektmappe (Projekt „Client“) entspricht der Projektstruktur für eine eigenständige Blazor WebAssembly-App. Zusätzliche Dateien in einer gehosteten Blazor WebAssembly-Lösung:
- Das Projekt „Server“ umfasst einen Wettervorhersagecontroller unter
Controllers/WeatherForecastController.cs, der Wetterdaten an die Client-Komponente des Projekts „FetchData“ zurückgibt. - Das Projekt „Shared“ enthält eine Wettervorhersageklasse unter
WeatherForecast.cs, die Wetterdaten für die Projekte „Client“ und „Server“ darstellt.
Speicherort des Blazor-Skripts
Das Skript Blazor wird als statische Webressource mit automatischer Komprimierung und Fingerprinting (Fingerabdruck) bereitgestellt. Weitere Informationen finden Sie unter Blazor in ASP.NET Core: statische Dateien.
In einer Blazor Web App befindet sich das Blazor-Skript in der Datei Components/App.razor:
<script src="@Assets["_framework/blazor.web.js"]"></script>
In einer Blazor Server-App befindet sich das Blazor-Skript in der Datei Pages/_Host.cshtml:
<script src="_framework/blazor.server.js"></script>
Das Skript Blazor wird in einer eingebetteten Ressource im freigegebenen ASP.NET Core-Framework bereitgestellt.
In einer Blazor Web App befindet sich das Blazor-Skript in der Datei Components/App.razor:
<script src="_framework/blazor.web.js"></script>
In einer Blazor Server-App befindet sich das Blazor-Skript in der Datei Pages/_Host.cshtml:
<script src="_framework/blazor.server.js"></script>
Das Skript Blazor wird in einer eingebetteten Ressource im freigegebenen ASP.NET Core-Framework bereitgestellt.
In einer Blazor Server-App befindet sich das Blazor-Skript in der Datei Pages/_Host.cshtml:
<script src="_framework/blazor.server.js"></script>
Das Skript Blazor wird in einer eingebetteten Ressource im freigegebenen ASP.NET Core-Framework bereitgestellt.
In einer Blazor Server-App befindet sich das Blazor-Skript in der Datei Pages/_Layout.cshtml:
<script src="_framework/blazor.server.js"></script>
Das Skript Blazor wird in einer eingebetteten Ressource im freigegebenen ASP.NET Core-Framework bereitgestellt.
In einer Blazor Server-App befindet sich das Blazor-Skript in der Datei Pages/_Host.cshtml:
<script src="_framework/blazor.server.js"></script>
Für eine Blazor Web App oder eine Blazor Server App muss das Projekt mindestens eine Razor Komponentendatei (.razor) enthalten, um das Blazor Skript automatisch einzuschließen, wenn die App veröffentlicht wird. Wenn das Projekt nicht mindestens eine Razor Komponente enthält, legen Sie die RequiresAspNetWebAssets MSBuild-Eigenschaft true in die Projektdatei der App fest, um das Blazor Skript einzuschließen:
<RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>
In einer Blazor WebAssembly-App befindet sich der Blazor-Skriptinhalt in der Datei wwwroot/index.html:
<script src="_framework/blazor.webassembly#[.{fingerprint}].js"></script>
Wenn die App veröffentlicht wird, wird der {fingerprint} Platzhalter automatisch durch einen eindeutigen Hash für die Cachebusting ersetzt.
<script src="_framework/blazor.webassembly.js"></script>
Speicherort der Inhalte <head> und <body>
In einer Blazor Web App, einer <head> und einer <body> befindet sich der Inhalt in der Datei Components/App.razor.
In einer Blazor Server-App befinden sich die Inhalte <head> und <body> in der Datei Pages/_Host.cshtml.
In einer Blazor Server-App befinden sich die Inhalte <head> und <body> in der Datei Pages/_Layout.cshtml.
In einer Blazor Server-App befinden sich die Inhalte <head> und <body> in der Datei Pages/_Host.cshtml.
In einer Blazor WebAssembly-App befinden sich die Inhalte <head> und <body> in der Datei wwwroot/index.html.
Dual Blazor Server/Blazor WebAssembly App
Ein Ansatz, um eine App zu erstellen, die entweder als Blazor Server App oder Blazor WebAssembly App ausgeführt werden kann, besteht darin, die ganze App-Logik und alle App-Komponenten in eine Razor Klassenbibliothek (RCL) zu platzieren und auf die RCL aus separaten Blazor Server und Blazor WebAssembly Projekten zu verweisen. Für allgemeine Dienste, deren Implementierungen sich je nach Hostingmodell unterscheiden, definieren Sie die Dienstschnittstellen in der RCL und implementieren sie die Dienste in den Blazor Server und Blazor WebAssembly Projekten.