Compartir a través de


Administración de estado de Blazor en ASP.NET Core

Nota

Esta no es la versión más reciente de este artículo. Para la versión actual, consulte la versión de .NET 9 de este artículo.

Advertencia

Esta versión de ASP.NET Core ya no se admite. Para obtener más información, consulta la Directiva de soporte técnico de .NET y .NET Core. Para la versión actual, consulta la versión .NET 8 de este artículo.

Importante

Esta información hace referencia a un producto en versión preliminar, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no proporciona ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.

Para la versión actual, consulte la versión de .NET 9 de este artículo.

En este artículo se describen los enfoques comunes para mantener los datos de un usuario (estado) mientras usa una aplicación y entre sesiones del explorador.

Nota:

En los ejemplos de código de este artículo se adoptan tipos de referencia que admiten un valor NULL (NRT) y análisis estático de estado NULL del compilador de .NET, que se admiten en ASP.NET Core en .NET 6 o posterior. Al tener como destino ASP.NET Core 5.0 o versiones anteriores, quite la designación de tipo null (?) de los tipos en los ejemplos del artículo.

Mantener el estado del usuario

El Blazor del lado servidor es un marco para aplicaciones con estado. La mayoría de las veces, la aplicación mantiene una conexión con el servidor. El estado del usuario se mantiene en la memoria del servidor en un circuito.

Entre los ejemplos de estado de usuario que se mantiene en un circuito se incluyen:

  • La jerarquía de instancias del componente y su salida de representación más reciente en la interfaz de usuario representada.
  • Los valores de los campos y las propiedades de las instancias del componente.
  • Los datos contenidos en las instancias de servicio de la inserción de dependencias (DI) que se encuentran en el ámbito del circuito.

También se puede encontrar el estado de usuario en las variables de JavaScript en el conjunto de la memoria del explorador mediante llamadas de interoperabilidad de JavaScript.

Si un usuario experimenta una pérdida de conexión de red temporal, Blazor intenta volver a conectar al usuario a su circuito original con su estado original. Sin embargo, no siempre es posible volver a conectar a un usuario con su circuito original en la memoria del servidor:

  • El servidor no puede mantener un circuito desconectado para siempre. El servidor debe liberar un circuito desconectado después de un tiempo de espera o cuando el servidor esté bajo presión de memoria.
  • En entornos de implementación de carga equilibrada y multiservidor, se puede producir un error en los servidores individuales o estos se pueden quitar automáticamente cuando ya no sean necesarios para controlar el volumen total de solicitudes. Las solicitudes de procesamiento de servidor originales de un usuario pueden dejar de estar disponibles cuando el usuario intenta volver a conectarse.
  • El usuario podría cerrar y volver a abrir el explorador o recargar la página, lo que elimina cualquier estado que se mantenga en la memoria del explorador. Por ejemplo, los valores de las variables de JavaScript establecidos mediante llamadas de interoperabilidad de JavaScript se pierden.

Cuando un usuario no se puede volver a conectar a su circuito original, el usuario recibe un circuito nuevo con un estado vacío. Esto es equivalente a cerrar y volver a abrir una aplicación de escritorio.

Conservación del estado entre circuitos

En general, se mantiene el estado en los circuitos en los que los usuarios crean datos de forma activa, no simplemente leyendo los datos que ya existen.

Para conservar el estado en los circuitos, la aplicación debe conservar los datos en otra ubicación de almacenamiento distinta a la memoria del servidor. La persistencia del estado no es automática. Debe seguir los pasos al desarrollar la aplicación para implementar la persistencia de datos con estado.

La persistencia de los datos normalmente solo es necesaria para el estado de alto valor que los usuarios crearon. En los ejemplos siguientes, el estado persistente ahorra tiempo o ayuda en las actividades comerciales:

  • Formularios web de varios pasos: en un formulario web que consta de varios pasos, en caso de que el estado se pierda, los usuarios tienen que dedicar mucho tiempo a volver a escribir los datos que ya han proporcionado. Un usuario pierde el estado en este escenario si se sale del formulario y vuelve más adelante.
  • Carros de la compra: se puede mantener cualquier componente comercial importante de una aplicación que represente ingresos potenciales. Un usuario que pierde su estado y, por tanto, su carro de la compra, puede comprar menos productos o servicios cuando vuelva al sitio más adelante.

Una aplicación solo puede conservar el estado de la aplicación. Las interfaces de usuario no se pueden conservar, como instancias de componentes y sus árboles de representación. Los componentes y los árboles de representación no suelen ser serializables. Para conservar el estado de la interfaz de usuario, como los nodos expandidos de un control de vista de árbol, la aplicación debe tener código personalizado para modelar el comportamiento del estado de la interfaz de usuario como estado de la aplicación serializable.

Dónde conservar el estado

Existen ubicaciones comunes para el estado persistente:

Almacenamiento del lado servidor

Para una persistencia de datos permanente que abarque varios usuarios y dispositivos, la aplicación puede usar el almacenamiento del lado servidor. Las opciones incluyen:

  • Blob Storage
  • Almacenamiento de pares clave-valor
  • Base de datos relacional
  • Almacenamiento de tablas

Una vez guardados los datos, el estado del usuario se conserva y está disponible en cualquier circuito nuevo.

Para obtener más información sobre las opciones de almacenamiento de datos de Azure, consulta lo siguiente:

Resolución

Para los datos transitorios que representan el estado de navegación, modela los datos como parte de la dirección URL. Entre los ejemplos de estado de usuario modelado en la dirección URL se incluyen:

  • El identificador de una entidad visualizada.
  • El número de la página actual en una cuadrícula paginada.

Se conserva el contenido de la barra de direcciones del explorador:

  • Si el usuario recarga manualmente la página.
  • Si el servidor web deja de estar disponible y el usuario se ve obligado a volver a cargar la página para conectarse a un servidor diferente.

Para obtener información sobre cómo definir patrones de dirección URL con la directiva @page, consulta Enrutamiento y navegación de Blazor en ASP.NET Core.

Almacenamiento del explorador

En el caso de los datos transitorios que el usuario crea activamente, una ubicación de almacenamiento que se suele usar son las colecciones localStorage y sessionStorage del explorador:

  • localStorage está en el ámbito de la ventana del explorador. Si el usuario recarga la página o la cierra y vuelve a abrir el explorador, el estado se conserva. Si el usuario abre varias pestañas del explorador, el estado se comparte entre las pestañas. Los datos se conservan en localStorage hasta que se borran explícitamente.
  • sessionStorage está en el ámbito de la pestaña del explorador. Si el usuario recarga la pestaña, el estado se conserva. Si el usuario cierra la pestaña o el explorador, se pierde el estado. Si el usuario abre varias pestañas del explorador, cada pestaña tendrá su propia versión independiente de los datos.

Por lo general, es más seguro usar sessionStorage. sessionStorage evita el riesgo de que un usuario abra varias pestañas y encuentre lo siguiente:

  • Errores en el almacenamiento de estado en todas las pestañas.
  • Comportamiento confuso cuando una pestaña sobrescribe el estado de otras.

localStorage es la mejor opción si la aplicación debe conservar el estado en el cierre y volver a abrir el explorador.

Advertencias sobre el uso del almacenamiento del explorador:

  • De forma similar al uso de una base de datos del lado servidor, la carga y el almacenamiento de datos son asincrónicos.
  • La página solicitada no existe en el explorador durante la representación previa, por lo que el almacenamiento local no está disponible durante la representación previa.
  • Es razonable almacenar unos pocos kilobytes de datos para las aplicaciones Blazor del lado servidor. Más allá de unos pocos kilobytes, debes tener en cuenta las implicaciones de rendimiento porque los datos se cargan y se guardan en la red.
  • Los usuarios pueden ver o alterar los datos. La protección de datos de ASP.NET Core puede mitigar el riesgo. Por ejemplo, el almacenamiento del explorador protegido de ASP.NET Core usa la protección de datos de ASP.NET Core.

Los paquetes NuGet de terceros proporcionan API para trabajar con localStorage y sessionStorage. Merece la pena tener en cuenta la elección de un paquete que utiliza de forma transparente la protección de datos de ASP.NET Core. La protección de datos cifra los datos almacenados y reduce el riesgo potencial de alteración de los datos almacenados. Si los datos serializados con JSON se almacenan como texto sin formato, los usuarios pueden ver los datos mediante las herramientas de desarrollo del explorador y también modificar los datos almacenados. La protección de datos triviales no es un problema. Por ejemplo, la lectura o modificación del color almacenado de un elemento de la interfaz de usuario no supone un riesgo de seguridad significativo para el usuario o la organización. Evita que los usuarios puedan inspeccionar o manipular información confidencial.

Almacenamiento del explorador protegido de ASP.NET Core

Por ejemplo, el almacenamiento del explorador protegido de ASP.NET Core usa la protección de datos de ASP.NET Core para localStorage y sessionStorage.

Nota:

El almacenamiento del explorador protegido se basa en la protección de datos de ASP.NET Core y solo se admite para aplicaciones Blazor del lado servidor.

Advertencia

Microsoft.AspNetCore.ProtectedBrowserStorage es un paquete experimental no compatible que no está pensado para su uso en producción.

El paquete solo está disponible para su uso en aplicaciones de ASP.NET Core 3.1.

Configuración

  1. Agrega una referencia de paquete a Microsoft.AspNetCore.ProtectedBrowserStorage.

    Nota

    Para obtener instrucciones sobre cómo agregar paquetes a aplicaciones .NET, consulta los artículos de Instalación y administración de paquetes en Flujo de trabajo de consumo de paquetes (documentación de NuGet). Confirma las versiones correctas del paquete en NuGet.org.

  2. En el archivo _Host.cshtml, agrega el siguiente script dentro de la etiqueta de cierre </body>:

    <script src="_content/Microsoft.AspNetCore.ProtectedBrowserStorage/protectedBrowserStorage.js"></script>
    
  3. En Startup.ConfigureServices, llama a AddProtectedBrowserStorage para agregar los servicios localStorage y sessionStorage a la colección de servicios:

    services.AddProtectedBrowserStorage();
    

Guardar y cargar datos dentro de un componente

En cualquier componente que requiera cargar o guardar datos en el almacenamiento del explorador, usa la directiva @inject para insertar una instancia de uno de los elementos siguientes:

  • ProtectedLocalStorage
  • ProtectedSessionStorage

La elección depende de la ubicación del almacenamiento del explorador que desees usar. En el ejemplo siguiente, se usa sessionStorage:

@using Microsoft.AspNetCore.Components.Server.ProtectedBrowserStorage
@inject ProtectedSessionStorage ProtectedSessionStore
@using Microsoft.AspNetCore.ProtectedBrowserStorage
@inject ProtectedSessionStorage ProtectedSessionStore

La directiva @using se puede colocar en el archivo _Imports.razor de la aplicación, en lugar de en el componente. El uso del archivo _Imports.razor hace que el espacio de nombres esté disponible para segmentos más grandes de la aplicación o para toda la aplicación.

Para conservar el valor de currentCount en el componente Counter de una aplicación basada en la plantilla del proyecto de Blazor, modifica el método IncrementCount para usar ProtectedSessionStore.SetAsync:

private async Task IncrementCount()
{
    currentCount++;
    await ProtectedSessionStore.SetAsync("count", currentCount);
}

En aplicaciones más grandes y realistas, el almacenamiento de campos individuales es un escenario improbable. Es más probable que las aplicaciones almacenen objetos de modelo completos que incluyen un estado complejo. ProtectedSessionStore serializa y deserializa automáticamente los datos de JSON para almacenar objetos de estado complejos.

En el ejemplo de código anterior, los datos de currentCount se almacenan como sessionStorage['count'] en el explorador del usuario. Los datos no se almacenan como texto sin formato, sino que se protegen mediante la protección de datos de ASP.NET Core. Los datos cifrados pueden inspeccionarse si se evalúa sessionStorage['count'] en la consola del desarrollador del explorador.

Para recuperar los datos de currentCount si el usuario vuelve al componente Counter más adelante, incluso si está en un circuito nuevo, use ProtectedSessionStore.GetAsync:

protected override async Task OnInitializedAsync()
{
    var result = await ProtectedSessionStore.GetAsync<int>("count");
    currentCount = result.Success ? result.Value : 0;
}
protected override async Task OnInitializedAsync()
{
    currentCount = await ProtectedSessionStore.GetAsync<int>("count");
}

Si los parámetros del componente incluyen el estado de navegación, llama a ProtectedSessionStore.GetAsync y asigna el resultado no null en OnParametersSetAsync, no OnInitializedAsync. OnInitializedAsync solo se llama una vez la primera vez que se crea una instancia del componente. OnInitializedAsync no se llama de nuevo más tarde si el usuario navega a una dirección URL diferente mientras permanece en la misma página. Para obtener más información, consulta Ciclo de vida del componente Razor de ASP.NET Core.

Advertencia

Los ejemplos de esta sección solo funcionan si el servidor no tiene habilitada la representación previa. Con la representación previa habilitada, se genera un error que explica que no se pueden emitir llamadas de interoperabilidad de JavaScript porque se está realizando una representación previa del componente.

Deshabilita la representación previa o agrega código adicional para trabajar con la representación previa. Para obtener más información sobre cómo escribir código que funcione con la representación previa, consulta la sección Controlar la representación previa.

Controlar el estado de carga

Dado que se accede al almacenamiento del explorador de forma asincrónica a través de una conexión de red, siempre hay un período de tiempo antes de que los datos se carguen y estén disponibles para un componente. Para obtener los mejores resultados, representa un mensaje mientras la carga está en curso, en lugar de mostrar datos en blanco o predeterminados.

Un enfoque consiste en realizar un seguimiento de si los datos son null, lo que significa que los datos aún se están cargando. En el componente Counter predeterminado, el recuento se mantiene en int. Haga que currentCount admita valores NULL agregando un signo de interrogación (?) al tipo (int):

private int? currentCount;

En lugar de mostrar de manera incondicional el recuento y el botón Increment , muestre estos elementos solo si se cargan los datos comprobando HasValue:

@if (currentCount.HasValue)
{
    <p>Current count: <strong>@currentCount</strong></p>
    <button @onclick="IncrementCount">Increment</button>
}
else
{
    <p>Loading...</p>
}

Controlar la representación previa

Durante la representación previa:

  • No existe ninguna conexión interactiva con el explorador del usuario.
  • El explorador todavía no tiene ninguna página en la que se pueda ejecutar código JavaScript.

localStorage o sessionStorage no están disponibles durante la representación previa. Si el componente intenta interactuar con el almacenamiento, se genera un error que explica que no se pueden emitir llamadas de interoperabilidad de JavaScript porque se está realizando una representación previa del componente.

Una manera de resolver el error es deshabilitar la representación previa. Esta suele ser la mejor opción si la aplicación hace un uso intensivo del almacenamiento basado en explorador. La representación previa agrega complejidad y no beneficia a la aplicación porque esta no puede representar previamente ningún contenido útil hasta que localStorage o sessionStorage estén disponibles.

Para deshabilitar la representación previa, indique el modo de representación con el parámetro prerender establecido en false en el componente de nivel más alto de la jerarquía de componentes de la aplicación que no sea un componente raíz.

Nota:

No se admite la creación de un componente raíz interactivo, como el componente App. Por lo tanto, el componente App no puede deshabilitar la representación previa directamente.

En el caso de las aplicaciones basadas en la plantilla de proyecto de Blazor Web App, la representación previa se deshabilita normalmente cuando se usa el componente Routes en el componente App (Components/App.razor):

<Routes @rendermode="new InteractiveServerRenderMode(prerender: false)" />

Además, deshabilite la representación previa para el componente de HeadOutlet:

<HeadOutlet @rendermode="new InteractiveServerRenderMode(prerender: false)" />

Para obtener más información, vea Modos de representación de Blazor de ASP.NET Core.

Para deshabilitar la representación previa, abra el archivo _Host.cshtml y cambie el atributo render-mode del asistente de etiquetas de componente a Server:

<component type="typeof(App)" render-mode="Server" />

Cuando la representación previa está deshabilitada, la representación previa del contenido de <head> está deshabilitada.

La representación previa puede resultar útil para otras páginas que no utilizan localStorage o sessionStorage. Para mantener la representación previa, postergue la operación de carga hasta que el explorador esté conectado al circuito. El siguiente es un ejemplo para almacenar un valor de contador:

@using Microsoft.AspNetCore.Components.Server.ProtectedBrowserStorage
@inject ProtectedLocalStorage ProtectedLocalStore

@if (isConnected)
{
    <p>Current count: <strong>@currentCount</strong></p>
    <button @onclick="IncrementCount">Increment</button>
}
else
{
    <p>Loading...</p>
}

@code {
    private int currentCount;
    private bool isConnected;

    protected override async Task OnAfterRenderAsync(bool firstRender)
    {
        if (firstRender)
        {
            isConnected = true;
            await LoadStateAsync();
            StateHasChanged();
        }
    }

    private async Task LoadStateAsync()
    {
        var result = await ProtectedLocalStore.GetAsync<int>("count");
        currentCount = result.Success ? result.Value : 0;
    }

    private async Task IncrementCount()
    {
        currentCount++;
        await ProtectedLocalStore.SetAsync("count", currentCount);
    }
}
@using Microsoft.AspNetCore.ProtectedBrowserStorage
@inject ProtectedLocalStorage ProtectedLocalStore

@if (isConnected)
{
    <p>Current count: <strong>@currentCount</strong></p>
    <button @onclick="IncrementCount">Increment</button>
}
else
{
    <p>Loading...</p>
}

@code {
    private int currentCount = 0;
    private bool isConnected = false;

    protected override async Task OnAfterRenderAsync(bool firstRender)
    {
        if (firstRender)
        {
            isConnected = true;
            await LoadStateAsync();
            StateHasChanged();
        }
    }

    private async Task LoadStateAsync()
    {
        currentCount = await ProtectedLocalStore.GetAsync<int>("count");
    }

    private async Task IncrementCount()
    {
        currentCount++;
        await ProtectedLocalStore.SetAsync("count", currentCount);
    }
}

Factorizar la preservación de estado en una ubicación común

Si muchos componentes se basan en el almacenamiento basado en explorador, al implementar el código del proveedor de estado muchas veces se crea la duplicación de código. Una opción para evitar la duplicación de código es crear un componente primario del proveedor de estado que encapsula la lógica del proveedor de estado. Los componentes secundarios pueden trabajar con datos persistentes sin tener en cuenta el mecanismo de persistencia del estado.

En el siguiente ejemplo de un componente CounterStateProvider, se conservan los datos del contador en sessionStorage:

@using Microsoft.AspNetCore.Components.Server.ProtectedBrowserStorage
@inject ProtectedSessionStorage ProtectedSessionStore

@if (isLoaded)
{
    <CascadingValue Value="this">
        @ChildContent
    </CascadingValue>
}
else
{
    <p>Loading...</p>
}

@code {
    private bool isLoaded;

    [Parameter]
    public RenderFragment? ChildContent { get; set; }

    public int CurrentCount { get; set; }

    protected override async Task OnInitializedAsync()
    {
        var result = await ProtectedSessionStore.GetAsync<int>("count");
        CurrentCount = result.Success ? result.Value : 0;
        isLoaded = true;
    }

    public async Task SaveChangesAsync()
    {
        await ProtectedSessionStore.SetAsync("count", CurrentCount);
    }
}
@using Microsoft.AspNetCore.ProtectedBrowserStorage
@inject ProtectedSessionStorage ProtectedSessionStore

@if (isLoaded)
{
    <CascadingValue Value="this">
        @ChildContent
    </CascadingValue>
}
else
{
    <p>Loading...</p>
}

@code {
    private bool isLoaded;

    [Parameter]
    public RenderFragment ChildContent { get; set; }

    public int CurrentCount { get; set; }

    protected override async Task OnInitializedAsync()
    {
        CurrentCount = await ProtectedSessionStore.GetAsync<int>("count");
        isLoaded = true;
    }

    public async Task SaveChangesAsync()
    {
        await ProtectedSessionStore.SetAsync("count", CurrentCount);
    }
}

Nota

Para obtener más información sobre RenderFragment, consulte Componentes de Razor de ASP.NET Core.

El componente CounterStateProvider controla la fase de carga, ya que no representa su contenido secundario hasta que se completa la carga de estado.

Para que el estado sea accesible a todos los componentes de una aplicación, encapsule el componente CounterStateProvider alrededor de Router (<Router>...</Router>) en el componente Routes con la representación global interactiva del lado servidor (SSR interactiva).

En el componente App (Components/App.razor):

<Routes @rendermode="InteractiveServer" />

En el componente Routes (Components/Routes.razor):

Para usar el componente CounterStateProvider, encapsule una instancia del componente en torno a cualquier otro componente que requiera acceso al estado del contador. Para que el estado sea accesible a todos los componentes de una aplicación, encapsule el componente CounterStateProvider alrededor de Router en el componente App (App.razor):

<CounterStateProvider>
    <Router ...>
        ...
    </Router>
</CounterStateProvider>

Nota:

Con la publicación de ASP.NET Core 5.0.1 y para las versiones 5.x adicionales, el componente Router incluye el parámetro PreferExactMatches establecido en @true. Para más información, vea Migración de ASP.NET Core 3.1 a 5.0.

Los componentes encapsulados reciben y pueden modificar el estado persistente del contador. El siguiente componente Counter implementa el patrón:

@page "/counter"

<p>Current count: <strong>@CounterStateProvider?.CurrentCount</strong></p>
<button @onclick="IncrementCount">Increment</button>

@code {
    [CascadingParameter]
    private CounterStateProvider? CounterStateProvider { get; set; }

    private async Task IncrementCount()
    {
        if (CounterStateProvider is not null)
        {
            CounterStateProvider.CurrentCount++;
            await CounterStateProvider.SaveChangesAsync();
        }
    }
}

No es necesario que el componente anterior interactúe con ProtectedBrowserStorage, ni se trata de una fase de carga.

Para tratar la representación previa tal y como se ha descrito anteriormente, CounterStateProvider se puede modificar para que todos los componentes que consumen los datos del contador funcionen automáticamente con la representación previa. Para obtener más información, vea la sección Controlar la representación previa.

En general, se recomienda el patrón componente primario del proveedor de estado:

  • Para consumir el estado en muchos componentes.
  • Si solo hay un objeto de estado de nivel superior para conservar.

Para conservar muchos objetos de estado diferentes y consumir distintos subconjuntos de objetos en distintos lugares, es mejor evitar la conservación global del estado.

El estado de usuario creado en una aplicación Blazor WebAssembly se guarda en la memoria del explorador.

Entre los ejemplos de estado de usuario almacenados en la memoria del explorador se incluyen:

  • La jerarquía de instancias del componente y su salida de representación más reciente en la interfaz de usuario representada.
  • Los valores de los campos y las propiedades de las instancias del componente.
  • Los datos contenidos en las instancias de servicio de la inserción de dependencias (DI).
  • Los valores establecidos mediante llamadas de interoperabilidad de JavaScript.

Cuando un usuario cierra y vuelve a abrir el explorador, o vuelve a cargar la página, se pierde el estado de usuario guardado en la memoria del explorador.

Nota:

El almacenamiento del explorador protegido (espacio de nombres Microsoft.AspNetCore.Components.Server.ProtectedBrowserStorage) se basa en la protección de datos de ASP.NET Core y solo se admite para aplicaciones Blazor del lado servidor.

Conservación del estado en todas las sesiones del explorador

En general, se mantiene el estado en las sesiones del explorador en las que los usuarios crean datos de forma activa, no simplemente leyendo los datos que ya existen.

Para conservar el estado en todas las sesiones del explorador, la aplicación debe conservar los datos en otra ubicación de almacenamiento distinta a la memoria del explorador. La persistencia del estado no es automática. Debe seguir los pasos al desarrollar la aplicación para implementar la persistencia de datos con estado.

La persistencia de los datos normalmente solo es necesaria para el estado de alto valor que los usuarios crearon. En los ejemplos siguientes, el estado persistente ahorra tiempo o ayuda en las actividades comerciales:

  • Formularios web de varios pasos: en un formulario web que consta de varios pasos, en caso de que el estado se pierda, los usuarios tienen que dedicar mucho tiempo a volver a escribir los datos que ya han proporcionado. Un usuario pierde el estado en este escenario si se sale del formulario y vuelve más adelante.
  • Carros de la compra: se puede mantener cualquier componente comercial importante de una aplicación que represente ingresos potenciales. Un usuario que pierde su estado y, por tanto, su carro de la compra, puede comprar menos productos o servicios cuando vuelva al sitio más adelante.

Una aplicación solo puede conservar el estado de la aplicación. Las interfaces de usuario no se pueden conservar, como instancias de componentes y sus árboles de representación. Los componentes y los árboles de representación no suelen ser serializables. Para conservar el estado de la interfaz de usuario, como los nodos expandidos de un control de vista de árbol, la aplicación debe tener código personalizado para modelar el comportamiento del estado de la interfaz de usuario como estado de la aplicación serializable.

Dónde conservar el estado

Existen ubicaciones comunes para el estado persistente:

Almacenamiento del lado servidor

Para una persistencia de datos permanente que abarque varios usuarios y dispositivos, la aplicación puede usar el almacenamiento del lado servidor independiente al que se accede a través de una API web. Las opciones incluyen:

  • Blob Storage
  • Almacenamiento de pares clave-valor
  • Base de datos relacional
  • Almacenamiento de tablas

Una vez guardados los datos, el estado del usuario se conserva y está disponible en cualquier nueva sesión del explorador.

Dado que las aplicaciones Blazor WebAssembly se ejecutan completamente en el explorador del usuario, requieren medidas adicionales para acceder a sistemas externos seguros, como bases de datos y servicios de almacenamiento. Las aplicaciones Blazor WebAssembly se protegen de la misma manera que las aplicaciones de página única (SPA). Normalmente, una aplicación autentica a un usuario a través de OAuth/OpenID Connect (OIDC) y, a continuación, interactúa con los servicios de almacenamiento y las bases de datos a través de llamadas de API web a una aplicación del lado servidor. La aplicación del lado servidor media en la transferencia de datos entre la aplicación Blazor WebAssembly y la base de datos o el servicio de almacenamiento. La aplicación Blazor WebAssembly mantiene una conexión efímera con la aplicación del lado servidor, mientras que la aplicación del lado servidor tiene una conexión persistente con el almacenamiento.

Para obtener más información, consulte los siguientes recursos:

Para obtener más información sobre las opciones de almacenamiento de datos de Azure, consulte lo siguiente:

Resolución

Para los datos transitorios que representan el estado de navegación, modela los datos como parte de la dirección URL. Entre los ejemplos de estado de usuario modelado en la dirección URL se incluyen:

  • El identificador de una entidad visualizada.
  • El número de la página actual en una cuadrícula paginada.

El contenido de la barra de direcciones del explorador se conserva si el usuario vuelve a cargar la página manualmente.

Para obtener información sobre cómo definir patrones de dirección URL con la directiva @page, consulta Enrutamiento y navegación de Blazor en ASP.NET Core.

Almacenamiento del explorador

En el caso de los datos transitorios que el usuario crea activamente, una ubicación de almacenamiento que se suele usar son las colecciones localStorage y sessionStorage del explorador:

  • localStorage está en el ámbito de la ventana del explorador. Si el usuario recarga la página o la cierra y vuelve a abrir el explorador, el estado se conserva. Si el usuario abre varias pestañas del explorador, el estado se comparte entre las pestañas. Los datos se conservan en localStorage hasta que se borran explícitamente.
  • sessionStorage está en el ámbito de la pestaña del explorador. Si el usuario recarga la pestaña, el estado se conserva. Si el usuario cierra la pestaña o el explorador, se pierde el estado. Si el usuario abre varias pestañas del explorador, cada pestaña tendrá su propia versión independiente de los datos.

Nota:

localStorage y sessionStorage se pueden usar en aplicaciones Blazor WebAssembly, pero solo escribiendo código personalizado o usando un paquete de terceros.

Por lo general, es más seguro usar sessionStorage. sessionStorage evita el riesgo de que un usuario abra varias pestañas y encuentre lo siguiente:

  • Errores en el almacenamiento de estado en todas las pestañas.
  • Comportamiento confuso cuando una pestaña sobrescribe el estado de otras.

localStorage es la mejor opción si la aplicación debe conservar el estado en el cierre y volver a abrir el explorador.

Advertencia

Los usuarios pueden ver o alterar los datos almacenados en localStorage y sessionStorage.

Servicio de contenedor de estado en memoria

Los componentes anidados normalmente enlazan datos mediante un enlace encadenado, y como se describe en Enlace de datos de Blazor en ASP.NET Core. Los componentes anidados y no anidados pueden compartir el acceso a los datos mediante un contenedor registrado de estado en memoria. Una clase de contenedor de estado personalizado puede usar un elemento Action asignable para notificar cambios de estado a los componentes en diferentes partes de la aplicación. En el ejemplo siguiente:

  • Un par de componentes usa un contenedor de estado para realizar el seguimiento de una propiedad.
  • Un componente del ejemplo siguiente está anidado en el otro componente, pero el anidamiento no es necesario para que este enfoque funcione.

Importante

En el ejemplo de esta sección se muestra cómo crear un servicio de contenedor de estado en memoria, registrarlo y usarlo en componentes. En el ejemplo no se conservan los datos sin un mayor desarrollo. Para el almacenamiento persistente de datos, el contenedor de estado debe adoptar un mecanismo de almacenamiento subyacente que sobrevive cuando se borra la memoria del explorador. Esto se puede lograr con localStorage/sessionStorage o con alguna otra tecnología.

StateContainer.cs:

public class StateContainer
{
    private string? savedString;

    public string Property
    {
        get => savedString ?? string.Empty;
        set
        {
            savedString = value;
            NotifyStateChanged();
        }
    }

    public event Action? OnChange;

    private void NotifyStateChanged() => OnChange?.Invoke();
}

Aplicaciones del lado cliente (archivo Program):

builder.Services.AddSingleton<StateContainer>();

Aplicaciones del lado servidor (archivo Program, ASP.NET Core en .NET 6 o posterior):

builder.Services.AddScoped<StateContainer>();

Aplicaciones del lado servidor (Startup.ConfigureServices de Startup.cs, ASP.NET Core anteriores a la 6.0):

services.AddScoped<StateContainer>();

Shared/Nested.razor:

@implements IDisposable
@inject StateContainer StateContainer

<h2>Nested component</h2>

<p>Nested component Property: <b>@StateContainer.Property</b></p>

<p>
    <button @onclick="ChangePropertyValue">
        Change the Property from the Nested component
    </button>
</p>

@code {
    protected override void OnInitialized()
    {
        StateContainer.OnChange += StateHasChanged;
    }

    private void ChangePropertyValue()
    {
        StateContainer.Property = 
            $"New value set in the Nested component: {DateTime.Now}";
    }

    public void Dispose()
    {
        StateContainer.OnChange -= StateHasChanged;
    }
}

StateContainerExample.razor:

@page "/state-container-example"
@implements IDisposable
@inject StateContainer StateContainer

<h1>State Container Example component</h1>

<p>State Container component Property: <b>@StateContainer.Property</b></p>

<p>
    <button @onclick="ChangePropertyValue">
        Change the Property from the State Container Example component
    </button>
</p>

<Nested />

@code {
    protected override void OnInitialized()
    {
        StateContainer.OnChange += StateHasChanged;
    }

    private void ChangePropertyValue()
    {
        StateContainer.Property = "New value set in the State " +
            $"Container Example component: {DateTime.Now}";
    }

    public void Dispose()
    {
        StateContainer.OnChange -= StateHasChanged;
    }
}

Los componentes anteriores implementan IDisposable, y se cancela la suscripción de los delegados de OnChange en los métodos Dispose, a los que llama el marco cuando se eliminan los componentes. Para obtener más información, consulta Ciclo de vida de los componentes Razor de ASP.NET Core.

Enfoques adicionales

Al implementar el almacenamiento de estado personalizado, un enfoque útil consiste en adoptar valores y parámetros en cascada:

  • Para consumir el estado en muchos componentes.
  • Si solo hay un objeto de estado de nivel superior para conservar.

Solución de problemas

En un servicio personalizado de administración de estados, la devolución de llamada invocada fuera del contexto de sincronización de Blazor debe encapsular la lógica de la devolución de llamada en ComponentBase.InvokeAsync para moverla al contexto de sincronización del representador.

Cuando el servicio de administración de estados no llama a StateHasChanged en el contexto de sincronización de Blazor, se produce el siguiente error:

System.InvalidOperationException: "El subproceso actual no está asociado a Dispatcher. Use InvokeAsync() para cambiar la ejecución a Dispatcher al desencadenar la representación o el estado del componente".

Para obtener más información y un ejemplo de cómo solucionar este error, vea representación de componentes de Razor ASP.NET Core.

Recursos adicionales