Persistir auxiliar de marca de estado do componente no ASP.NET Core

  • Artigo

O Auxiliar de Marca de Estado do Componente Persistente salva o estado de componentes Razor não roteáveis renderizados em uma página ou exibição de um aplicativo MVC ou Páginas do Razor.

Pré-requisitos

Siga as diretrizes na seção Usar componentes não roteáveis em páginas ou exibições do artigo Integrar componentes ASP.NET Core Razor em aplicativos ASP.NET Core.

Confira as diretrizes na seção de Configuração para:

Manter o estado para componentes pré-renderizados

Para persistir o estado em componentes pré-renderizados, use o Auxiliar de Marcação de Estado do Componente Persistente (fonte de referência). Adicione a marca do Auxiliar de Marca, <persist-component-state />, dentro da marca </body> de fechamento do layout em um aplicativo que pré-processa componentes.

Observação

Os links de documentação para a fonte de referência do .NET geralmente carregam o branch padrão do repositório, que representa o desenvolvimento atual da próxima versão do .NET. Para selecionar uma marca para uma versão específica, use a lista suspensa para Alternar branches ou marcas. Para saber mais, confira Como selecionar uma marca de versão do código-fonte do ASP.NET Core (dotnet/AspNetCore.Docs #26205).

Em Pages/Shared/_Layout.cshtml para componentes inseridos que sejam pré-renderizados pelo WebAssembly (WebAssemblyPrerendered) ou pré-renderizados pelo servidor (ServerPrerendered):

<body>
    ...

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

Decida qual estado persistir usando o serviço PersistentComponentState. PersistentComponentState.RegisterOnPersisting registra um retorno de chamada para a persistência do estado do componente antes que o aplicativo seja pausado. Há recuperação do estado com a retomada do aplicativo.

Para obter mais informações e exemplos, consulte Pré-renderização de componentes Razor ASP.NET Core.

Para persistir o estado em componentes pré-renderizados, use o Auxiliar de Marcação de Estado do Componente Persistente (fonte de referência). Adicione a marca do Auxiliar de Marca, <persist-component-state />, dentro da marca de fechamento </body> da página _Host em um aplicativo que remete componentes.

Observação

Os links de documentação para a fonte de referência do .NET geralmente carregam o branch padrão do repositório, que representa o desenvolvimento atual da próxima versão do .NET. Para selecionar uma marca para uma versão específica, use a lista suspensa para Alternar branches ou marcas. Para saber mais, confira Como selecionar uma marca de versão do código-fonte do ASP.NET Core (dotnet/AspNetCore.Docs #26205).

Em Pages/_Host.cshtml de Blazor aplicativos que são pré-renderizados pelo WebAssembly (WebAssemblyPrerendered) em um aplicativo Blazor WebAssembly hospedado ou ServerPrerendered em um aplicativo Blazor Server:

<body>
    ...

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

Decida qual estado persistir usando o serviço PersistentComponentState. PersistentComponentState.RegisterOnPersisting registra um retorno de chamada para a persistência do estado do componente antes que o aplicativo seja pausado. Há recuperação do estado com a retomada do aplicativo.

Para obter mais informações e exemplos, confira Pré-renderizar e integrar os componentes Razor do ASP.NET Core.

Recursos adicionais