0Pricing
C# Academy · Lezione

Gestione dello stato in Blazor

Gestisca lo stato condiviso con singleton di servizio, Fluxor o AppState a cascata per mantenere coerente l'interfaccia tra i componenti.

Gestione dello stato in Blazor è una lezione C# Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento C# Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso C# Academy include 4 lezioni in totale.

Le sfide della gestione dello stato in Blazor

Quando le app Blazor crescono, gestire lo stato che deve essere condiviso tra molti componenti non correlati diventa complesso. La semplice propagazione delle props non è più sufficiente: serve uno store di stato centralizzato e reattivo.

Stato semplice con un servizio scoped

La soluzione più semplice per gestire lo stato in Blazor consiste in un servizio scoped che conserva lo stato ed espone un evento a cui i componenti possono iscriversi per ricevere le modifiche.

public class CartState
{
    private readonly List<CartItem> _items = new();
    public IReadOnlyList<CartItem> Items => _items;
    public int Count => _items.Sum(i => i.Quantity);

    public event Action? OnChanged;

    public void Add(Product p)
    {
        var existing = _items.FirstOrDefault(i => i.ProductId == p.Id);
        if (existing is not null) existing.Quantity++;
        else _items.Add(new CartItem { ProductId = p.Id, Name = p.Name, Price = p.Price });
        OnChanged?.Invoke();
    }
}

Sottoscrizione alle modifiche dello stato

I componenti si iscrivono all'evento OnChanged del servizio di stato e chiamano StateHasChanged per eseguire nuovamente il rendering. Ricordi di annullare la sottoscrizione in Dispose.

@inject CartState Cart
@implements IDisposable

<p>Cart: @Cart.Count items</p>

@code {
    protected override void OnInitialized()
    {
        Cart.OnChanged += OnCartChanged;
    }

    private void OnCartChanged()
    {
        InvokeAsync(StateHasChanged);
    }

    public void Dispose() =>
        Cart.OnChanged -= OnCartChanged;
}

CascadingValue come contenitore dello stato

Avvolga il layout principale in un CascadingValue che contenga il servizio di stato. Tutti i discendenti possono accedervi senza dover propagare esplicitamente le props.

@* MainLayout.razor *@
@inject CartState Cart

<CascadingValue Value="Cart">
    @Body
</CascadingValue>

@* Any nested component: *@
@code {
    [CascadingParameter]
    public CartState Cart { get; set; } = default!;

    private void Buy(Product p) => Cart.Add(p);
}

Fluxor: il pattern Flux per Blazor

Fluxor porta in Blazor il flusso di dati unidirezionale in stile Redux: State → Component → Action → Reducer → State. È ideale per le applicazioni complesse.

// dotnet add package Fluxor.Blazor.Web

// State record
[FeatureState]
public record CounterState(int Count = 0);

// Actions
public record IncrementAction(int Amount = 1);

// Reducers
public static class CounterReducers
{
    [ReducerMethod]
    public static CounterState Reduce(CounterState state, IncrementAction action)
        => state with { Count = state.Count + action.Amount };
}

// Registration:
builder.Services.AddFluxor(opt =>
    opt.ScanAssemblies(typeof(Program).Assembly));

Utilizzo di Fluxor in un componente

Inietti IState<T> per leggere lo stato e IDispatcher per inviare le azioni. InheritsFrom<FluxorComponent> (o il mixin) sottoscrive automaticamente il componente alle modifiche dello stato.

@inherits FluxorComponent
@inject IState<CounterState> CounterState
@inject IDispatcher Dispatcher

<p>Count: @CounterState.Value.Count</p>
<button @onclick="Increment">+1</button>
<button @onclick="() => Dispatcher.Dispatch(new IncrementAction(5))">+5</button>

@code {
    private void Increment()
        => Dispatcher.Dispatch(new IncrementAction(1));
}

Persistenza in LocalStorage

Conservi lo stato tra gli aggiornamenti della pagina utilizzando il localStorage del browser tramite l'interoperabilità JavaScript. Lo ripristini all'avvio dell'app.

@inject IJSRuntime JS

@code {
    private async Task SaveStateAsync()
    {
        var json = JsonSerializer.Serialize(_state);
        await JS.InvokeVoidAsync("localStorage.setItem", "appState", json);
    }

    protected override async Task OnInitializedAsync()
    {
        var json = await JS.InvokeAsync<string?>("localStorage.getItem", "appState");
        if (json is not null)
            _state = JsonSerializer.Deserialize<AppState>(json) ?? new();
    }

    private AppState _state = new();
}

Pacchetto Blazored.LocalStorage

Il pacchetto Blazored.LocalStorage fornisce un'API tipizzata e intuitiva per il localStorage del browser, senza dover scrivere manualmente chiamate di interoperabilità JavaScript.

// dotnet add package Blazored.LocalStorage
builder.Services.AddBlazoredLocalStorage();

@inject ILocalStorageService LocalStorage

@code {
    protected override async Task OnInitializedAsync()
    {
        _cart = await LocalStorage.GetItemAsync<List<CartItem>>("cart") ?? new();
    }

    private async Task SaveCartAsync()
    {
        await LocalStorage.SetItemAsync("cart", _cart);
    }

    private List<CartItem> _cart = new();
}

Stato nell'URL con NavigationManager

Utilizzi i parametri di query per conservare lo stato che deve sopravvivere a un aggiornamento della pagina e poter essere incluso nei segnalibri. Li legga e li scriva tramite NavigationManager e il generatore di URI.

@inject NavigationManager Nav
@page "/products"

@code {
    [SupplyParameterFromQuery] public string? Search { get; set; }
    [SupplyParameterFromQuery] public int Page { get; set; } = 1;

    private void UpdateSearch(string s)
    {
        Nav.NavigateTo(
            Nav.GetUriWithQueryParameters(
                new Dictionary<string, object?>
                {
                    [nameof(Search)] = s,
                    [nameof(Page)]   = 1
                }));
    }
}

Caso reale: stato del carrello

Un pattern completo: un servizio scoped CartState con eventi, persistito nel localStorage a ogni modifica e ripristinato al caricamento.

public class CartState
{
    private readonly ILocalStorageService _storage;
    private List<CartItem> _items = new();
    public event Action? OnChanged;

    public CartState(ILocalStorageService storage) => _storage = storage;

    public async Task InitAsync()
    {
        _items = await _storage.GetItemAsync<List<CartItem>>("cart") ?? new();
    }

    public async Task AddAsync(Product p)
    {
        var item = _items.FirstOrDefault(i => i.ProductId == p.Id);
        if (item is not null) item.Quantity++;
        else _items.Add(new CartItem { ProductId = p.Id, Name = p.Name });
        await _storage.SetItemAsync("cart", _items);
        OnChanged?.Invoke();
    }
}

Verifica rapida

Quale approccio alla gestione dello stato è più adatto a una semplice app Blazor con uno stato condiviso limitato?

Riepilogo: gestione dello stato in Blazor

Punti chiave:

  • Servizio scoped + evento Action: stato condiviso semplice, adatto alla maggior parte delle app
  • Un CascadingValue che avvolge il componente principale fornisce accesso a livello di app senza propagare le props
  • Fluxor: flusso unidirezionale in stile Redux per una logica di stato complessa
  • Persistenza dello stato nel localStorage con IJSRuntime o Blazored.LocalStorage
  • Stato nell'URL (SupplyParameterFromQuery) per uno stato dell'interfaccia inseribile nei segnalibri e condivisibile
  • Annulli sempre la sottoscrizione agli eventi in Dispose per evitare perdite di memoria

Domande Frequenti

La lezione «Gestione dello stato in Blazor» è gratuita?

Sì — il testo completo di «Gestione dello stato in Blazor» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso C# Academy, passa a CoddyKit PRO. Il corso C# Academy include 4 lezioni in totale.

Cosa imparerò in «Gestione dello stato in Blazor»?

Gestisca lo stato condiviso con singleton di servizio, Fluxor o AppState a cascata per mantenere coerente l'interfaccia tra i componenti. Eserciti C# Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare C# Academy?

Non è richiesta alcuna esperienza precedente. C# Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Gestione dello stato in Blazor»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione C# Academy?

Sì. Ogni lezione C# Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Modello dei componenti Blazor
  2. Data binding e gestione degli eventi
  3. Comunicazione tra componenti e DI
  4. Gestione dello stato in Blazor
← Torna a C# Academy