Hilfsprogramm „Persist Component State Tag“ in ASP.NET Core

  • Artikel

Die Hilfsprogramm „Persist Component State Tag“ speichert den Zustand nicht routingfähiger Razor-Komponenten, die in einer Seite oder Ansicht einer Razor Pages- oder MVC-App gerendert werden.

Voraussetzungen

Befolgen Sie die Anleitungen im Abschnitt Verwenden nicht routingfähiger Komponenten in Seiten oder Ansichten des Artikels Integrieren von ASP.NET Core Razor-Komponenten in ASP.NET Core-Apps.

Befolgen Sie die Anweisungen im Abschnitt Konfiguration, um eine der folgenden Aktionen durchzuführen:

Beibehalten des Zustands für Komponenten, die vorab gerendert werden

Um den Zustand für vorab gerenderte Komponenten beizubehalten, verwenden Sie das Hilfsprogramm „Persist Component State Tag“ (Referenzquelle). Fügen Sie das Hilfsprogramm-Tag <persist-component-state /> innerhalb des schließenden </body>-Tags des Layouts in einer App hinzu, die Komponenten vorab rendert.

Hinweis

Dokumentationslinks zur .NET-Referenzquelle laden in der Regel den Standardbranch des Repositorys, der die aktuelle Entwicklung für das nächste Release von .NET darstellt. Um ein Tag für ein bestimmtes Release auszuwählen, wählen Sie diesen mit der Dropdownliste Switch branches or tags (Branches oder Tags wechseln) aus. Weitere Informationen finden Sie unter How to select a version tag of ASP.NET Core source code (dotnet/AspNetCore.Docs #26205) (Auswählen eines Versionstags von ASP.NET Core-Quellcode (dotnet/AspNetCore.Docs #26205)).

In Pages/Shared/_Layout.cshtml für eingebettete Komponenten, die entweder von WebAssembly (WebAssemblyPrerendered) oder dem Server (ServerPrerendered) vorab gerendert wurden:

<body>
    ...

    <persist-component-state />
</body>

Entscheiden Sie, welcher Zustand mithilfe des Diensts PersistentComponentState beibehalten werden soll. Mit PersistentComponentState.RegisterOnPersisting wird zum Beibehalten des Komponentenzustands ein Rückruf registriert, bevor die App angehalten wird. Der Zustand wird abgerufen, wenn die Anwendung fortgesetzt wird.

Weitere Informationen und Beispiele finden Sie unter Vorabrendering von ASP.NET Core Razor-Komponenten.

Um den Zustand für vorab gerenderte Komponenten beizubehalten, verwenden Sie das Hilfsprogramm „Persist Component State Tag“ (Referenzquelle). Fügen Sie das Hilfsprogramm-Tag <persist-component-state /> innerhalb des schließenden </body>-Tags der Seite _Host in einer App hinzu, die Komponenten vorab rendert.

Hinweis

Dokumentationslinks zur .NET-Referenzquelle laden in der Regel den Standardbranch des Repositorys, der die aktuelle Entwicklung für das nächste Release von .NET darstellt. Um ein Tag für ein bestimmtes Release auszuwählen, wählen Sie diesen mit der Dropdownliste Switch branches or tags (Branches oder Tags wechseln) aus. Weitere Informationen finden Sie unter How to select a version tag of ASP.NET Core source code (dotnet/AspNetCore.Docs #26205) (Auswählen eines Versionstags von ASP.NET Core-Quellcode (dotnet/AspNetCore.Docs #26205)).

In Pages/_Host.cshtml von Blazor Anwendungen, die entweder in einer gehosteten Blazor WebAssembly-Anwendung mit WebAssembly vorgerendert sind (WebAssemblyPrerendered) oder in einer Blazor Server-Anwendung mit ServerPrerendered:

<body>
    ...

    <persist-component-state />
</body>

Entscheiden Sie, welcher Zustand mithilfe des Diensts PersistentComponentState beibehalten werden soll. Mit PersistentComponentState.RegisterOnPersisting wird zum Beibehalten des Komponentenzustands ein Rückruf registriert, bevor die App angehalten wird. Der Zustand wird abgerufen, wenn die Anwendung fortgesetzt wird.

Weitere Informationen und Beispiele finden Sie unter Prerendering und Integrieren von Razor-Komponenten in ASP.NET Core.

Zusätzliche Ressourcen