Blazor QuickGrid：创建无需填充RenderFragment的自定义列遇渲染问题

问题原因 #

QuickGrid的列收集逻辑依赖组件的参数变更检测机制。你的自定义CheckboxColumn继承自ColumnBase<TGridItem>，如果没有显式设置HeaderTemplate、Align这类自带参数变更通知的属性，Blazor可能会判定该列没有状态变化，在网格重渲染时无法正确保留它。这类核心参数本身带有[Parameter]特性，变更时会触发组件状态更新；而当它们为默认的null值时，QuickGrid的列收集逻辑可能在重渲染过程中忽略该列。

解决办法 #

1. 给自定义列设置默认HeaderTemplate #

在CheckboxColumn的构造函数或参数初始化中，给HeaderTemplate赋值一个空的RenderFragment，避免它为null：

public class CheckboxColumn<TGridItem> : ColumnBase<TGridItem>
{
    public CheckboxColumn()
    {
        // 设置默认空模板，确保列被持续识别
        HeaderTemplate = builder => { };
    }

    // 你的复选框渲染逻辑...
}

2. 重写SetParametersAsync强制状态更新 #

在自定义列中重写SetParametersAsync，确保无论参数是否变化，都触发组件状态更新：

public override async Task SetParametersAsync(ParameterView parameters)
{
    await base.SetParametersAsync(parameters);
    // 强制触发组件状态更新，确保列被网格正确收集
    StateHasChanged();
}

3. 强制QuickGrid整体重渲染 #

如果需要强制整个网格重渲染，可以给QuickGrid绑定@key属性，通过改变key值让Blazor重建整个网格组件：

@page "/your-page"

@{
    int gridRenderKey = 1;
}

<QuickGrid Items="@yourData" @key="gridRenderKey">
    <CheckboxColumn />
    <!-- 其他列 -->
</QuickGrid>

<button @onclick="() => gridRenderKey++">强制刷新网格</button>

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