Udostępnij przez

Utrwalanie pomocnika tagu stanu składnika w ASP.NET Core

  • Artykuł

Pomocnik utrwalania stanu składnika zapisuje stan składników niezwiązanych Razor z routingiem renderowanych na stronie lub w widoku Razor stron lub aplikacji MVC.

Wymagania wstępne

Postępuj zgodnie ze wskazówkami w sekcji Use non-routable components in pages or views (Używanie składników niezwiązanych z routingem na stronach lub widokach) artykułu Integrate ASP.NET Core components into ASP.NET Core apps (Integrowanie składników platformy ASP.NET Core Razor w aplikacjach platformy ASP.NET Core).

Postępuj zgodnie ze wskazówkami w sekcji Konfiguracja dla jednego z następujących rozwiązań:

Stan utrwalania dla wstępnie wstępnie wstępnie wyeksenderowanych składników

Aby utrwały stan dla wstępnie wstępnie użytych składników, należy użyć pomocnika tagu stanu składnika (źródło referencyjne). Dodaj tag <persist-component-state />Pomocnika tagu , wewnątrz tagu zamykającego </body> układu w aplikacji, która prerenders składników.

Uwaga

Linki dokumentacji do źródła referencyjnego platformy .NET zwykle ładują domyślną gałąź repozytorium, która odzwierciedla bieżące programowanie dla następnej wersji platformy .NET. Aby wybrać tag dla określonej wersji, użyj listy rozwijanej Przełącz gałęzie lub tagi. Aby uzyskać więcej informacji, zobacz Jak wybrać tag wersji kodu źródłowego platformy ASP.NET Core (dotnet/AspNetCore.Docs #26205).

W Pages/Shared/_Layout.cshtml przypadku składników osadzonych, które są wstępnie wstępnie skompenderowane (WebAssemblyPrerendered) lub prerendered serwera (ServerPrerendered):

<body>
    ...

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

Zdecyduj, jaki stan ma być trwały przy użyciu PersistentComponentState usługi. PersistentComponentState.RegisterOnPersisting rejestruje wywołanie zwrotne, aby utrwało stan składnika przed wstrzymaniem aplikacji. Stan jest pobierany po wznowieniu działania aplikacji.

Aby uzyskać więcej informacji i przykładów, zobacz Prerender ASP.NET Core components (Składniki prerender ASP.NET CoreRazor).

Aby utrwały stan dla wstępnie wstępnie użytych składników, należy użyć pomocnika tagu stanu składnika (źródło referencyjne). Dodaj tag <persist-component-state />Pomocnika tagu , wewnątrz tagu _Host zamykającego </body> strony w aplikacji, która prerenders składników.

Uwaga

Linki dokumentacji do źródła referencyjnego platformy .NET zwykle ładują domyślną gałąź repozytorium, która odzwierciedla bieżące programowanie dla następnej wersji platformy .NET. Aby wybrać tag dla określonej wersji, użyj listy rozwijanej Przełącz gałęzie lub tagi. Aby uzyskać więcej informacji, zobacz Jak wybrać tag wersji kodu źródłowego platformy ASP.NET Core (dotnet/AspNetCore.Docs #26205).

W Pages/_Host.cshtml aplikacjach Blazor , które są wstępnie obsługiwane przez zestaw WebAssembly (WebAssemblyPrerendered) w hostowanej Blazor WebAssembly aplikacji lub ServerPrerendered w Blazor Server aplikacji:

<body>
    ...

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

Zdecyduj, jaki stan ma być trwały przy użyciu PersistentComponentState usługi. PersistentComponentState.RegisterOnPersisting rejestruje wywołanie zwrotne, aby utrwało stan składnika przed wstrzymaniem aplikacji. Stan jest pobierany po wznowieniu działania aplikacji.

Aby uzyskać więcej informacji i przykładów, zobacz Prerender i integrowanie składników ASP.NET CoreRazor.

Dodatkowe zasoby