ASP.NET MVC迁移.NET Core时Ajax.BeginForm转jquery.unobtrusive-ajax失效问题
.NET Core 迁移场景下 Unobtrusive Ajax 表单整页刷新问题解决
现象描述
- 从传统 ASP.NET MVC Web 应用迁移至 .NET Core 时,框架内置的
Ajax.BeginForm辅助方法不再可用,改用 jQuery Unobtrusive Ajax 方式实现原有的无刷新表单提交功能时,始终无法正常运行 - 对照搭建两套业务逻辑完全一致的测试项目:传统 ASP.NET MVC 版本的表单可按预期完成 Ajax 提交,仅更新指定 div 容器内容;.NET Core 版本提交表单时直接触发整页刷新,将返回的分部视图替换整个页面内容
核心代码实现
.NET Core 版本最初编写的表单代码:
<form asp-action="EmployeeMaster" asp-controller="Home" data-ajax-method="POST" data-ajax-update="#divEmp" data-ajax-mode="replace" class="row search-box cols-bottom"> <!-- 表单内部字段逻辑与传统版本完全一致 --> <div class="form-horizontal"> <hr /> @Html.ValidationSummary(true, "", new { @class = "text-danger" }) <div class="form-group"> @Html.LabelFor(model => model.Name, htmlAttributes: new { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Name, new { htmlAttributes = new { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Name, "", new { @class = "text-danger" }) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.City, htmlAttributes: new { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.City, new { htmlAttributes = new { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.City, "", new { @class = "text-danger" }) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Address, htmlAttributes: new { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Address, new { htmlAttributes = new { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Address, "", new { @class = "text-danger" }) </div> </div> <div class="form-group"> <div class="col-md-offset-2 col-md-10"> <input type="submit" value="Save" class="btn btn-primary" /> </div> </div> <hr /> <div class="form-group"> <div class="col-md-offset-2 col-md-12 text-success"> @ViewBag.Records </div> </div> </div> </form>
传统 ASP.NET MVC 版本对应的原始实现(迁移时注释保留的参考代码):
@*@using (Ajax.BeginForm("EmployeeMaster", "Home", new AjaxOptions { HttpMethod = "POST", UpdateTargetId = "divEmp", InsertionMode = InsertionMode.Replace, OnSuccess = "reloadContent()", }, new { @class = "row search-box cols-bottom" })) { @Html.AntiForgeryToken() // 表单内部字段逻辑与 .NET Core 版本完全一致 }*@
注:代码中提到的 reloadContent() 目前为空实现函数
问题根因与修复
对比两个项目最终渲染到浏览器端的 HTML 代码可以定位问题:.NET Core 版本生成的表单标签上缺失 data-ajax="true" 属性。
jQuery Unobtrusive Ajax 脚本的核心触发逻辑为:只有检测到表单元素携带 data-ajax="true" 标记时,才会拦截表单的原生提交事件,后续读取其他 data-ajax-* 配置项完成异步请求逻辑。缺失该标记时,脚本完全不会介入表单行为,表单会走原生的同步提交流程,最终触发整页刷新跳转。
在表单标签上手动补上缺失的核心触发属性即可修复问题,修复后的表单标签:
<form asp-action="EmployeeMaster" asp-controller="Home" data-ajax="true" data-ajax-method="POST" data-ajax-update="#divEmp" data-ajax-mode="replace" data-ajax-success="reloadContent()" class="row search-box cols-bottom">
迁移注意事项
- 传统 ASP.NET MVC 的
Ajax.BeginForm辅助方法会自动在生成的表单标签上加上data-ajax="true"标记,.NET Core 没有内置的等效辅助方法,所有 Unobtrusive Ajax 相关的配置属性都需要手动写到表单标签上,脚本不会自动生成这个核心触发标记 - 确认项目中已经正确引入 jQuery 基础库和
jquery.unobtrusive-ajax脚本,避免因脚本加载顺序错误、文件缺失导致的功能失效 - 补齐
data-ajax="true"后,表单提交就会按照配置走异步请求,将返回的分部视图替换到#divEmp容器中,不再触发整页刷新
内容的提问来源于stack exchange,提问作者Herald Gjura
相关产品推荐
相关产品推荐

