Radzen Blazor DataGrid 中 IQueryable 数据源的选择保持问题解析

在使用 Radzen Blazor 的 DataGrid 组件时，开发者可能会遇到一个关于数据选择和虚拟化的常见问题：当使用 IQueryable 作为数据源并启用虚拟化时，滚动后选择项会消失。本文将从技术角度深入分析这个问题，并提供解决方案。

问题现象

当 DataGrid 使用 IQueryable 作为数据源并启用虚拟化功能时，用户选择行后，一旦滚动列表，之前的选择就会丢失。这与使用常规集合（如 List）时的行为不同。

根本原因分析

这个问题本质上与 .NET 的对象相等性比较机制有关。当 DataGrid 需要保持选择状态时，它依赖于对象的 HashCode 来识别和匹配选择项。在使用动态生成的 IQueryable 数据时，每次访问集合都会创建新的对象实例，即使它们包含相同的数据，也会产生不同的 HashCode。

技术细节

1. 对象标识问题：在示例代码中，每次枚举 IQueryable 都会生成全新的 OrderDetail 对象，这些对象虽然数据相同，但引用不同。

2. 虚拟化机制：虚拟化功能会动态加载和卸载可视区域外的数据，这导致组件需要不断重新查询数据源。

3. 选择保持机制：DataGrid 通过比较对象引用来保持选择状态，当对象被重新创建时，选择关联就会断开。

解决方案

方案一：使用稳定数据源

对于静态数据，可以先将 IQueryable 转换为 List 或其他集合类型：

orderDetails = dbContext.OrderDetails.ToList();

方案二：实现自定义相等比较

如果必须使用 IQueryable，可以为数据模型实现 IEquatable 接口，重写 Equals 和 GetHashCode 方法：

public class OrderDetail : IEquatable<OrderDetail>
{
    public bool Equals(OrderDetail other)
    {
        return OrderID == other.OrderID && ProductID == other.ProductID;
    }
    
    public override int GetHashCode()
    {
        return HashCode.Combine(OrderID, ProductID);
    }
}

方案三：使用键属性

Radzen DataGrid 支持通过设置 RowSelect 事件和 Value 绑定来手动管理选择状态：

<RadzenDataGrid @bind-Value="@selectedItems" RowSelect="@OnRowSelect">
    <!-- 列定义 -->
</RadzenDataGrid>

@code {
    IList<OrderDetail> selectedItems = new List<OrderDetail>();
    
    void OnRowSelect(OrderDetail item)
    {
        // 基于ID而不是对象引用来管理选择
        var existing = selectedItems.FirstOrDefault(x => x.OrderID == item.OrderID);
        if(existing != null)
        {
            selectedItems.Remove(existing);
        }
        else
        {
            selectedItems.Add(item);
        }
    }
}

最佳实践建议

1. 对于小型数据集，优先考虑使用内存集合（如 List）而非 IQueryable
2. 对于大型数据集必须使用虚拟化时，确保数据模型有明确的键属性
3. 考虑实现稳定且高效的相等比较逻辑
4. 在复杂场景下，可以结合使用 RowSelect 事件和自定义选择管理逻辑

通过理解这些底层机制和解决方案，开发者可以更好地在 Radzen Blazor 项目中实现稳定可靠的数据选择功能。