0Pricing
C# Academy · 강의

Blazor의 상태 관리

서비스 싱글턴, Fluxor 또는 계단식 AppState로 공유 상태를 관리해 구성 요소 전체에서 UI를 일관되게 유지합니다.

Blazor의 상태 관리은(는) CoddyKit의 무료 C# Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 C# Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

Blazor의 상태 관리 과제

Blazor 앱이 커지면 서로 관련 없는 여러 컴포넌트에서 공유해야 하는 상태를 관리하기가 복잡해집니다. 단순히 속성을 여러 단계로 전달하는 방식으로는 부족하므로 중앙 집중식 반응형 상태 저장소가 필요합니다.

범위 지정 서비스로 간단하게 상태 관리하기

가장 간단한 Blazor 상태 관리 방법은 상태를 보유하고 컴포넌트가 변경 사항을 구독할 수 있도록 이벤트를 노출하는 범위 지정 서비스를 사용하는 것입니다.

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();
    }
}

상태 변경 구독하기

컴포넌트는 상태 서비스의 OnChanged 이벤트를 구독하고 StateHasChanged를 호출하여 다시 렌더링합니다. 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

루트 레이아웃을 상태 서비스가 포함된 CascadingValue로 감싸십시오. 모든 하위 컴포넌트가 속성을 명시적으로 여러 단계 전달하지 않고도 해당 서비스에 액세스할 수 있습니다.

@* 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: Blazor용 Flux 패턴

Fluxor는 Redux 스타일의 단방향 데이터 흐름을 Blazor에 제공합니다. 상태 → 컴포넌트 → 작업 → 리듀서 → 상태의 흐름이며, 복잡한 애플리케이션에 적합합니다.

// 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));

컴포넌트에서 Fluxor 사용하기

상태를 읽으려면 IState<T>를 주입하고, 작업을 디스패치하려면 IDispatcher를 주입하십시오. InheritsFrom<FluxorComponent>(또는 믹스인)를 사용하면 상태 변경을 자동으로 구독합니다.

@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));
}

LocalStorage를 사용한 상태 유지

JavaScript 상호 운용을 통해 브라우저 localStorage에 상태를 저장하면 페이지를 새로 고쳐도 상태를 유지할 수 있습니다. 앱 시작 시 상태를 복원하십시오.

@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();
}

Blazored.LocalStorage 패키지

Blazored.LocalStorage 패키지는 JavaScript 상호 운용 호출을 직접 작성하지 않고도 브라우저 localStorage를 편리하게 사용할 수 있는 형식 지정 API를 제공합니다.

// 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();
}

NavigationManager를 사용한 URL 상태

페이지를 새로 고쳐도 유지되고 북마크로 저장할 수 있는 상태는 쿼리 매개 변수에 보관하십시오. NavigationManager와 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
                }));
    }
}

실전: 장바구니 상태

완전한 패턴은 다음과 같습니다. 이벤트가 있는 범위 지정 CartState 서비스를 사용하고, 변경 시 localStorage에 저장하며, 로드할 때 복원합니다.

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();
    }
}

빠른 확인

공유 상태가 제한적인 간단한 Blazor 앱에는 어떤 상태 관리 방식이 가장 적합합니까?

복습: Blazor의 상태 관리

핵심 요점:

  • 범위 지정 서비스 + 작업 이벤트: 가장 간단한 공유 상태 방식으로 대부분의 앱에 적합
  • 루트를 감싸는 CascadingValue: 속성을 여러 단계로 전달하지 않고 앱 전체에서 액세스 가능
  • Fluxor: 복잡한 상태 로직을 위한 Redux 스타일 단방향 흐름
  • IJSRuntime 또는 Blazored.LocalStorage를 사용하여 localStorage에 상태 저장
  • URL 상태(SupplyParameterFromQuery): 북마크하고 공유할 수 있는 UI 상태에 사용
  • 메모리 누수를 방지하려면 항상 Dispose에서 이벤트 구독 해제

자주 묻는 질문

“Blazor의 상태 관리” 강의는 무료인가요?

네 — “Blazor의 상태 관리” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 C# Academy 강의 전체를 잠금 해제할 수 있습니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“Blazor의 상태 관리”에서 뭘 배우나요?

서비스 싱글턴, Fluxor 또는 계단식 AppState로 공유 상태를 관리해 구성 요소 전체에서 UI를 일관되게 유지합니다. 브라우저에서 직접 실행하는 실습 코드로 C# Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

C# Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 C# Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“Blazor의 상태 관리” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 C# Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 C# Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. Blazor 구성 요소 모델
  2. 데이터 바인딩과 이벤트 처리
  3. 구성 요소 통신과 DI
  4. Blazor의 상태 관리
← C# Academy(으)로 돌아가기