You need to enable JavaScript to run this app. KendoUI Grid预选中行功能异常,是否应使用异步控制器方法?
优惠活动
大模型
产品
解决方案
定价
更多

KendoUI Grid预选中行功能异常,是否应使用异步控制器方法?

Kendo UI Grid 行预选中不稳定问题的根因与修复方案

核心根因

  • 问题本质不是服务端响应耗时、也不是需要更换异步Controller,是前端执行时机的竞态问题:
    1. Kendo Grid的选中状态(包括PersistSelection机制依赖的_selectedIds),必须等Grid自身的DataSource完成数据拉取、触发dataBound事件完成行渲染之后,再赋值才能生效。当前实现是在DOM加载完成就并行发起两个自定义Ajax请求,拿到ID就直接写_selectedIds,大概率会赶在Grid自身的Read请求返回、渲染完成之前执行赋值,后续Grid渲染流程会把未绑定到渲染行的选中标记直接清空。之前测试加服务端延迟偶发生效,本质是赌两个并行请求的返回先后顺序,没有稳定性保障。
    2. 代码存在选择器大小写不匹配的低级错误:Vessel Grid在Razor中配置的Name是VesselGrid(大写V开头),前端JS取实例时写的是$("#vesselGrid")(小写v开头),严格选择器匹配场景下会直接取不到Grid实例,导致操作完全失效。
    3. 当前写法的async Task<JsonResult>是伪异步:方法内部没有任何await的异步IO调用,全是同步内存查询,加async关键字没有实际性能收益,也完全解决不了时序问题。

稳定实现的修复方案

1. 调整Grid配置,绑定生命周期事件

给两个Grid加上dataBound事件绑定,确保选中逻辑永远在Grid行渲染完成之后执行:

<!-- Vessel Grid 配置补充 -->
@(Html.Kendo().Grid<Vessel>()
    .Name("VesselGrid")
    // ... 保留原有所有配置
    .Events(events => events.DataBound("onVesselGridDataBound"))
    .DataSource(dataSource => dataSource
        .Ajax()
        // ... 保留原有所有DataSource配置
    )
)

<!-- Column Grid 配置补充 -->
@(Html.Kendo().Grid<VesselColumn>()
    .Name("columnGrid")
    // ... 保留原有所有配置
    .Events(events => events.DataBound("onColumnGridDataBound"))
    .DataSource(dataSource => dataSource
        .Ajax()
        // ... 保留原有所有DataSource配置
    )
)

2. 重写前端逻辑,彻底解决竞态

逻辑核心是:先缓存选中ID,等两个条件任意满足时就执行选中(要么Grid渲染完成时已经有缓存的ID,要么选中ID返回时Grid已经渲染完成),不管哪个请求先到都不会出错。

// 全局缓存两个Grid的预选中ID列表
let preSelectedVesselIds = [];
let preSelectedColumnIds = [];

$(function () {     
    // 并行拉取预选中数据,只存值,不直接操作Grid
    $.ajax({
        type: 'POST',
        url: '/Test/ReadUserVessels',
        data: { Id: 230 },
        success: function (data) {
            preSelectedVesselIds = data.vessels.map(item => item.VesselId);
            // 如果Grid已经渲染完成,立刻执行选中
            const grid = $("#VesselGrid").getKendoGrid();
            if (grid && grid.dataSource.total() > 0) {
                applyVesselSelection(grid);
            }
        }
    });

    $.ajax({
        type: 'POST',
        url: '/Test/ReadUserColumns',
        data: { Id: 230 },
        success: function (data) {
            preSelectedColumnIds = data.columns.map(item => item.ColumnId);
            const grid = $("#columnGrid").getKendoGrid();
            if (grid && grid.dataSource.total() > 0) {
                applyColumnSelection(grid);
            }
        }
    });
});

// Grid行渲染完成时的触发逻辑
function onVesselGridDataBound() {
    applyVesselSelection($("#VesselGrid").getKendoGrid());
}
function onColumnGridDataBound() {
    applyColumnSelection($("#columnGrid").getKendoGrid());
}

// 封装Vessel选中方法
function applyVesselSelection(grid) {
    const currentRows = grid.dataSource.view();
    currentRows.forEach(item => {
        if (preSelectedVesselIds.includes(item.Id)) {
            // 用公开API选中行,不要直接操作私有属性
            grid.select(`tr[data-uid='${item.uid}']`);
        }
    });
}

// 封装Column选中方法
function applyColumnSelection(grid) {
    const currentRows = grid.dataSource.view();
    currentRows.forEach(item => {
        if (preSelectedColumnIds.includes(item.Id)) {
            grid.select(`tr[data-uid='${item.uid}']`);
        }
    });
}

关于异步Controller的说明

如果要优化服务端吞吐量,可以把Service层的数据库查询改成真正的异步调用(比如EF Core的ToListAsync、ADO.NET的异步查询API),替换掉现在的同步ToList()逻辑,但是这和当前的选中失效问题完全无关——哪怕把所有接口都改成真正的异步,只要还是在DOM加载完成就直接操作未初始化完成的Grid,选中问题依然会存在。


内容的提问来源于stack exchange,提问作者Yanayaya

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 05:24:04