Asistente de etiquetas de conservación del estado del componente en ASP.NET Core

  • Artículo

El asistente de etiquetas de estado de componente persistente guarda el estado de los componentes Razor no enrutables representados en una página o vista de una aplicación MVC o Razor Pages.

Requisitos previos

Siga las indicaciones de la sección Uso de componentes no enrutables en páginas o vistas del artículo Integración de componentes ASP.NET Core Razor en aplicaciones de ASP.NET Core.

Siga las instrucciones de la sección Configuración para:

Mantenimiento del estado de los componentes representados previamente

Para conservar el estado de los componentes representados previamente, use el asistente de etiquetas de conservación del estado del componente (origen de referencia). Agregue la etiqueta del asistente de etiquetas, <persist-component-state />, dentro de la etiqueta de cierre </body> del diseño en una aplicación que representa previamente los componentes.

Nota:

Los vínculos de la documentación al origen de referencia de .NET cargan normalmente la rama predeterminada del repositorio, que representa el desarrollo actual para la próxima versión de .NET. Para seleccionar una etiqueta de una versión específica, use la lista desplegable Cambiar ramas o etiquetas. Para obtener más información, vea Procedimientos para seleccionar una etiqueta de versión de código fuente de ASP.NET Core (dotnet/AspNetCore.Docs #26205).

En Pages/Shared/_Layout.cshtml para los componentes integrados que estén representados previamente por WebAssembly (WebAssemblyPrerendered) o por el servidor (ServerPrerendered):

<body>
    ...

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

En la aplicación, decida qué estado quiere conservar mediante el servicio PersistentComponentState. PersistentComponentState.RegisterOnPersisting registra una devolución de llamada para conservar el estado del componente antes de que se pause la aplicación. El estado se recupera cuando se reanuda la aplicación.

Para más información y ejemplos, consulte Representación previa de componentes Razor de ASP.NET Core.

Para conservar el estado de los componentes representados previamente, use el asistente de etiquetas de conservación del estado del componente (origen de referencia). Agregue la etiqueta del asistente de etiquetas, <persist-component-state />, dentro de la etiqueta de cierre </body> de la página _Host en una aplicación que representa previamente los componentes.

Nota:

Los vínculos de la documentación al origen de referencia de .NET cargan normalmente la rama predeterminada del repositorio, que representa el desarrollo actual para la próxima versión de .NET. Para seleccionar una etiqueta de una versión específica, use la lista desplegable Cambiar ramas o etiquetas. Para obtener más información, vea Procedimientos para seleccionar una etiqueta de versión de código fuente de ASP.NET Core (dotnet/AspNetCore.Docs #26205).

En Pages/_Host.cshtml de Blazor de las aplicaciones que están prerrenderizadas (WebAssemblyPrerendered) en una aplicación de Blazor WebAssembly hospedada o ServerPrerendered en una aplicación de Blazor Server:

<body>
    ...

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

En la aplicación, decida qué estado quiere conservar mediante el servicio PersistentComponentState. PersistentComponentState.RegisterOnPersisting registra una devolución de llamada para conservar el estado del componente antes de que se pause la aplicación. El estado se recupera cuando se reanuda la aplicación.

Para obtener más información y ejemplos, consulte Prerrenderizar e integrar componentes ASP.NET Core Razor.

Recursos adicionales