You need to enable JavaScript to run this app. ASP.NET MVC迁移.NET Core时Ajax.BeginForm转jquery.unobtrusive-ajax失效问题
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.12 16:15:05