Persist Component State Tag Helper in ASP.NET Core

  • Articolo

L'helper Persist Component State Tag salva lo stato dei componenti non instradabili Razor di cui viene eseguito il rendering in una pagina o in una visualizzazione di un'app Razor Pages o MVC.

Prerequisiti

Seguire le indicazioni riportate nella sezione Usare componenti non instradabili nelle pagine o nelle visualizzazioni dell'articolo Integrare componenti ASP.NET Core Razor in ASP.NET app Core.

Seguire le indicazioni nella sezione Configurazione per:

Mantenere lo stato per i componenti prerisorsi

Per mantenere lo stato per i componenti prerenderati, usare l'helper Persist Component State Tag (origine di riferimento). Aggiungere il tag dell'helper tag, <persist-component-state />, all'interno del tag di chiusura </body> del layout in un'app che prerendere i componenti.

Nota

I collegamenti della documentazione all'origine del riferimento .NET in genere caricano il ramo predefinito del repository, che rappresenta lo sviluppo corrente per la versione successiva di .NET. Per selezionare un tag per una versione specifica, usare l'elenco a discesa Switch branches or tags. Per altre informazioni, vedere How to select a version tag of ASP.NET Core source code (dotnet/AspNetCore.Docs #26205) (Come selezionare un tag di versione del codice sorgente di ASP.NET - dotnet/AspNetCore.Docs #26205).

In Pages/Shared/_Layout.cshtml per i componenti incorporati prerendered (WebAssemblyPrerendered) o server prerendered (ServerPrerendered):

<body>
    ...

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

Decidere quale stato rendere persistente usando il PersistentComponentState servizio. PersistentComponentState.RegisterOnPersisting registra un callback per rendere persistente lo stato del componente prima che l'app venga sospesa. Lo stato viene recuperato quando l'applicazione riprende.

Per altre informazioni ed esempi, vedere Prerender ASP.NET Componenti di baseRazor.

Per mantenere lo stato per i componenti prerenderati, usare l'helper Persist Component State Tag (origine di riferimento). Aggiungere il tag dell'helper tag, <persist-component-state />, all'interno del tag di chiusura </body> della _Host pagina in un'app che prerendere i componenti.

Nota

I collegamenti della documentazione all'origine del riferimento .NET in genere caricano il ramo predefinito del repository, che rappresenta lo sviluppo corrente per la versione successiva di .NET. Per selezionare un tag per una versione specifica, usare l'elenco a discesa Switch branches or tags. Per altre informazioni, vedere How to select a version tag of ASP.NET Core source code (dotnet/AspNetCore.Docs #26205) (Come selezionare un tag di versione del codice sorgente di ASP.NET - dotnet/AspNetCore.Docs #26205).

In Pages/_Host.cshtml delle Blazor app prerenderate (WebAssemblyPrerendered) di WebAssembly in un'app ospitata Blazor WebAssembly o ServerPrerendered in un'app Blazor Server :

<body>
    ...

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

Decidere quale stato rendere persistente usando il PersistentComponentState servizio. PersistentComponentState.RegisterOnPersisting registra un callback per rendere persistente lo stato del componente prima che l'app venga sospesa. Lo stato viene recuperato quando l'applicazione riprende.

Per altre informazioni ed esempi, vedere Prerender and integrate ASP.NET Core components .For more information and examples, see Prerender and integrate ASP.NET Core Razor components.

Risorse aggiuntive