为什么我的.NET Core标签助手在HTML按钮上无法正常生效？

问题原因及修复方案 #

你遇到的断点不触发的问题由几个常见的表单提交配置错误导致，按以下步骤修改即可：

• 错误1：按钮类型配置错误
  你当前按钮的type="button"是普通按钮，默认没有表单提交行为，只有type="submit"的按钮才会触发所在表单的提交动作。
• 错误2：缺少表单标签包裹
  asp-controller、asp-action这类表单相关的标签助手需要作用在<form>标签上，单独给按钮配置不会生成有效的提交地址，同时上传文件必须给form加enctype="multipart/form-data"属性，否则文件无法正常传输到后端。
• 错误3：缺少文件选择控件
  后端接收的IFormFile files参数需要对应前端的文件选择框，且控件的name属性必须和参数名完全一致。
• 可选优化：路由参数名统一，把asp-route-Id改为全小写的asp-route-id，和控制器方法的入参名完全匹配，避免路由匹配异常。

修复后的视图代码示例 #

<form asp-controller="Home" asp-action="UploadDocument" asp-route-id="@Model.Project.Id" method="post" enctype="multipart/form-data">
    <div class="input-group">
        <!-- 新增文件选择框，name和后端参数名保持一致为files -->
        <input type="file" class="form-control" name="files" required>
        <div class="input-group-append">
            <button
                class="btn btn-outline-secondary"
                type="submit"
                id="uploadDocument"
            >
                Upload
            </button>
        </div>
    </div>
</form>

额外排查建议 #

如果修改后仍然无法触发断点，可以打开浏览器F12开发者工具的网络面板，点击提交后查看：

1. 请求地址是否为/Home/UploadDocument/{你的id}
2. 请求方法是否为POST
3. 是否返回400错误：如果是400大概率是防伪验证失败，可以在控制器方法上加[IgnoreAntiforgeryToken]临时测试，生产环境建议保留防伪验证，form标签会自动生成防伪令牌无需额外配置。

内容的提问来源于stack exchange，提问作者NerdyDriod