.NET 8 Blazor级联参数变更后OnParameterSet未触发的解决咨询

问题原因 #

.NET 8 对Blazor的级联值更新逻辑做了优化：只有当级联参数的引用发生变化时，才会触发组件的OnParametersSet/OnParametersSetAsync方法。而你之前的做法是直接修改级联对象（CascadingProps）的内部属性，对象本身的引用没有改变，所以新版本中不会触发参数更新流程。

解决方案：通过INotifyPropertyChanged实现属性变更通知 #

让CascadingProps类实现INotifyPropertyChanged接口，当属性修改时主动通知订阅的组件，组件收到通知后触发状态更新（可手动调用StateHasChanged，或间接触发OnParametersSet逻辑）。

步骤1：修改CascadingProps类 #

using System.ComponentModel;
using System.Runtime.CompilerServices;

public class CascadingProps : INotifyPropertyChanged
{
    private int _rowId;
    private DateTime _sysDate;

    public int RowId
    {
        get => _rowId;
        set
        {
            if (_rowId != value)
            {
                _rowId = value;
                OnPropertyChanged();
            }
        }
    }

    public DateTime SysDate
    {
        get => _sysDate;
        set
        {
            if (_sysDate != value)
            {
                _sysDate = value;
                OnPropertyChanged();
            }
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;

    protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

步骤2：在使用级联参数的组件中订阅变更事件 #

以Counter.razor为例，实现IDisposable来订阅和取消订阅属性变更事件，触发组件更新：

@page "/counter"
@rendermode InteractiveServer
@implements IDisposable

<PageTitle>Counter</PageTitle>

<h1>Counter</h1>

<p role="status">Current count: @currentCount</p>

<button class="btn btn-primary" @onclick="IncrementCount">Click me</button>

<br />
@CscdProps.RowId
<br/>
@CscdProps.SysDate


@code {
    [CascadingParameter(Name = "CascadingProps")]
    public CascadingProps CscdProps { get; set; }

    private int currentCount = 0;

    protected override void OnInitialized()
    {
        CscdProps?.PropertyChanged += OnCascadingPropsUpdated;
    }

    private void OnCascadingPropsUpdated(object sender, PropertyChangedEventArgs e)
    {
        // 触发组件重新渲染，同时可以在这里调用原OnParametersSet中的逻辑
        StateHasChanged();
        // 如果需要复用OnParametersSetAsync的逻辑，可直接调用：
        // await OnParametersSetAsync();
    }

    private void IncrementCount()
    {
        currentCount++;
    }

    protected override Task OnParametersSetAsync()
    {
        // 这里处理参数变更后的业务逻辑
        return base.OnParametersSetAsync();
    }

    public void Dispose()
    {
        // 取消订阅，避免内存泄漏
        CscdProps?.PropertyChanged -= OnCascadingPropsUpdated;
    }
}

替代方案：更新级联值的引用（不推荐） #

如果你不想实现INotifyPropertyChanged，可以每次修改属性时替换整个CascadingProps对象的引用，但这种方式会导致所有依赖该级联值的组件都触发更新，性能和代码优雅性不如前者：

// 在NavHeader.razor的OnDateChange方法中修改：
private void OnDateChange(DateTime dt)
{
    dateSelect = dt;
    // 替换整个对象引用
    CscdProps = new CascadingProps { RowId = CscdProps.RowId, SysDate = dt };
}

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