
本文详解在部分视图(partial view)中动态刷新 kendo ui grid 的标准做法,重点解决通过复选框触发、向服务端传递新参数时 url 缺失查询参数的问题,推荐使用 `datasource.read(data)` 而非直接修改 `transport.read.data`。
在 ASP.NET MVC 中将 Kendo UI Grid 嵌入部分视图并实现动态刷新,是常见但易出错的场景。你遇到的核心问题——调用 grid.dataSource.read() 后请求 URL 未携带预期参数——根本原因在于错误地通过赋值方式篡改了 Kendo DataSource 的内部 transport 配置(grid.dataSource.transport.read.data = data),这不仅违背 Kendo 官方推荐实践,还可能因配置缓存或异步时机导致参数失效。
✅ 正确做法是:直接将参数对象传入 read() 方法,Kendo 会自动将其作为额外查询参数附加到 AJAX 请求中:
function refreshInvoiceList() {
console.log('refreshInvoiceList function called.');
var data = getInvoicesFilter();
var grid = $("#PrintedCheckInvoiceList").data("kendoGrid");
if (grid) {
// ✅ 推荐:直接传参,无需修改 transport 配置
grid.dataSource.read(data);
} else {
console.error("Kendo Grid with ID 'PrintedCheckInvoiceList' not found.");
}
}同时,请确保你的控制器 PrintedCheckInvoiceList_Read 动作方法签名能接收所有参数:
public ActionResult PrintedCheckInvoiceList_Read([DataSourceRequest] DataSourceRequest request,
string checkNo, int assocBankAcctID, int assocAcctLedgerID, bool fetchAllItems)
{
// 构建 IQueryable 或 List
var data = GetData(checkNo, assocBankAcctID, assocAcctLedgerID, fetchAllItems);
return Json(data.ToDataSourceResult(request), JsonRequestBehavior.AllowGet);
} ⚠️ 注意事项:
- 避免直接操作 transport.read.data:该属性为只读配置快照,运行时修改无效且不可靠;
- 确保 Grid 已完全初始化:$(document).ready() 中调用 refreshInvoiceList() 可能早于 Grid 渲染完成,建议在 RenderAction 后或使用 kendo.widgetInstance 等机制校验;
- 检查网络请求:使用浏览器开发者工具 Network 标签页验证请求 URL 是否包含 &fetchAllItems=true&checkNo=... 等参数;
- Partial View 中不重复初始化 Grid:你当前在 RenderAction 中调用了 PrintedCheckInvoiceList_Read —— 这仅返回数据,而非渲染 Grid;真正的 Grid 渲染应由主视图中的 @Html.Kendo().Grid(...) 完成,因此 RenderAction 应替换为 @{ Html.RenderPartial("_PrintedCheckInvoiceList", Model); } 或类似逻辑,避免混淆数据与 UI 渲染职责。
总结:Kendo UI DataSource 的 read(data) 方法是动态传参的标准接口,简洁、可靠、符合设计规范。坚持这一模式,可显著提升部分视图中 Grid 交互的稳定性与可维护性。










