ASP.NET Core Blazor级联参数为空：父组件如何获取子组件参数？

场景需求 #

父组件需要获取子组件的参数并供自身使用。

现有代码 #

父组件后台代码 #

[Parameter]
public List<TItem>? DataItems { get; set; }
public List<ColumnDefinition>? Columns { get; set; }
[Parameter]
public RenderFragment? ChildContent { get; set; }

public void AddColumn(ColumnDefinition columnDefinition)
{
    if (Columns is null)
        Columns = new();
    Columns.Add(columnDefinition);
    StateHasChanged();
}

子组件后台代码 #

[CascadingParameter]
public DataGridComponent<TItem>? ContainerDataGridComponent { get; set; }
[Parameter]
public required ColumnDefinition ColumnDefinition { get; set; } 

protected override void OnInitialized()
{
    base.OnInitialized();
    ContainerDataGridComponent?.AddColumn(ColumnDefinition);
}

启动代码 #

<DataGridComponent DataItems="PersonDtos" TItem="PersonDto">
    <ColumnComponent TItem="PersonDto" ColumnDefinition="@(new(){DataField = "FirstName", Caption="First Name" })"></ColumnComponent>
    <ColumnComponent TItem="PersonDto" ColumnDefinition="@(new(){DataField = "LastName", Caption = "Last Name"})"></ColumnComponent>
    <ColumnComponent TItem="PersonDto" ColumnDefinition="@(new(){DataField = "CreatedDate", Caption = "Created Date"})"></ColumnComponent>
    <ColumnComponent TItem="PersonDto" ColumnDefinition="@(new(){DataField = "UpdatedDate", Caption = "Updated Date"})"></ColumnComponent>
</DataGridComponent>

问题 #

子组件中被[CascadingParameter]修饰的ContainerDataGridComponent属性始终为null，如何解决？

解决步骤 #

1. 父组件添加级联值传递 #

级联参数需要父组件主动将自身作为级联值传递给子组件，修改父组件的Razor视图，用CascadingValue组件包裹ChildContent：

@* 父组件的Razor文件内容 *@
<CascadingValue Value="this">
    @ChildContent
</CascadingValue>

这是核心修复步骤：只有父组件通过CascadingValue暴露自身，子组件的[CascadingParameter]才能捕获到对应的实例。

2. 确保泛型类型完全匹配 #

确认子组件的泛型参数TItem与父组件的TItem完全一致。比如父组件是DataGridComponent<PersonDto>，子组件ColumnComponent<PersonDto>中的级联参数DataGridComponent<TItem>就会正确匹配到父组件实例，避免因泛型不匹配导致捕获失败。

3. 验证生命周期时机（可选） #

子组件在OnInitialized生命周期中调用AddColumn是合理的，因为级联参数会在组件初始化阶段完成赋值。如果后续仍有问题，可以尝试将调用移至OnAfterRender（添加首次渲染判断避免重复执行）：

protected override void OnAfterRender(bool firstRender)
{
    base.OnAfterRender(firstRender);
    if (firstRender)
    {
        ContainerDataGridComponent?.AddColumn(ColumnDefinition);
    }
}

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