Blazor参数绑定为何需StateHasChanged？如何规避？

问题场景复现 #

子组件代码：

<h3>@IsEnabled</h3>

@code {
    [Parameter]
    public bool IsEnabled { get; set; }
}

页面代码（修改后仍需手动调用StateHasChanged的版本）：

@page "/"

<PageTitle>Binding Test</PageTitle>

<BlazorBindingTest.Components.MyComponent IsEnabled="@IsEnabled"></BlazorBindingTest.Components.MyComponent>

@code
{
    public bool IsEnabled { get; set; } = false;

    protected override async Task OnAfterRenderAsync(bool firstRender)
    {
        if (firstRender)
        {
            _ = Task.Run(myInfinityLoop);
        }
    }

    private async Task myInfinityLoop()
    {
        while (true)
        {
            IsEnabled = !IsEnabled;
            await Task.Delay(1000);
            //StateHasChanged(); // 必须手动调用才能更新UI
        }
    }
}

为何必须调用StateHasChanged？ #

Blazor的自动UI更新仅在框架托管的执行上下文中触发，包括：

• 用户交互事件（如按钮点击、输入框变更）
• 组件生命周期方法（如OnInitializedAsync、OnParametersSetAsync）
• 由框架调度的异步操作完成时（如通过InvokeAsync执行的代码）

你的场景中：

1. myInfinityLoop通过Task.Run启动，运行在线程池线程中，脱离了Blazor的同步上下文，框架无法感知这里的状态变更。
2. 即便在OnAfterRenderAsync的循环中，该方法是在组件渲染完成后执行，后续的异步延迟操作不在框架的自动更新触发范围内，因此修改IsEnabled后，框架不知道需要重新渲染UI。

如何避免手动调用StateHasChanged？ #

有两种常用方案可以自动触发UI更新：

1. 使用InvokeAsync回到Blazor同步上下文

将状态修改逻辑包装在InvokeAsync中，代码会回到Blazor的同步上下文执行，框架会自动触发StateHasChanged：

private async Task myInfinityLoop()
{
    while (true)
    {
        // 用InvokeAsync包装状态修改，自动触发UI更新
        await InvokeAsync(() => 
        {
            IsEnabled = !IsEnabled;
        });
        await Task.Delay(1000);
    }
}

2. 在属性 setter 中自动触发更新

通过自定义属性的setter，在状态变更时自动调用InvokeAsync(StateHasChanged)，任何地方修改属性都会触发UI更新：

private bool _isEnabled;
public bool IsEnabled
{
    get => _isEnabled;
    set
    {
        if (_isEnabled != value)
        {
            _isEnabled = value;
            // 自动触发UI更新，无需手动调用
            _ = InvokeAsync(StateHasChanged);
        }
    }
}

补充说明 #

• 避免直接在后台线程中修改组件状态，始终通过InvokeAsync将状态操作切换到Blazor上下文，这是Blazor开发的最佳实践。
• StateHasChanged的性能影响并没有想象中严重，Blazor会通过虚拟DOM对比只更新需要变化的部分，但自动触发的方式更符合框架设计模式，也更易维护。

内容的提问来源于stack exchange，提问作者ITCBB