ASP.NET Core MVC 3.1 HttpPost方法无法接收选中复选框值问题

核心错误原因 #

ASP.NET MVC 默认模型绑定器解析List<T>类型参数时，要求表单提交的同组元素name属性严格遵循[Action参数名].[集合索引].属性名的命名规则。
当前实现的核心问题是视图使用foreach循环渲染复选框、隐藏域时，生成的表单元件name属性没有携带集合索引标记，不符合绑定规则，因此Post动作方法无法解析提交的表单数据，接收到的集合计数始终为0。
其他容易触发同类问题的细节：

• 未勾选的复选框默认不会随表单提交值，若未配套提交对应false值的隐藏域，会导致集合索引断连
• 表单元件的name前缀和Post方法的集合参数名不匹配
• 集合索引不连续时未额外提交索引标记，导致绑定器提前终止解析

修复实现 #

1. 调整视图渲染逻辑 #

将视图的模型类型改为List<Practice.MVC.Models.Category>，把foreach循环替换为带数字索引的for循环，使用Html辅助方法生成带正确name属性的表单元件：

@model List<Practice.MVC.Models.Category>
@using (Html.BeginForm("GetSelectedCheckBoxes", "Test", FormMethod.Post))
{
    for (int i = 0; i < Model.Count; i++)
    {
        // 提交分类基础属性
        @Html.HiddenFor(m => m[i].CategoryId)
        @Html.HiddenFor(m => m[i].CategoryName)
        <div class="form-check">
            @* CheckBoxFor会自动生成值为false的同名隐藏域，保证未选中状态也能提交值 *@
            @Html.CheckBoxFor(m => m[i].CheckboxAnswer, new { @class = "form-check-input" })
            @Html.LabelFor(m => m[i].CheckboxAnswer, Model[i].CategoryName, new { @class = "form-check-label" })
        </div>
    }
    <button type="submit" class="btn btn-primary">提交选中项</button>
}

2. 确认Post动作方法参数匹配 #

保证Post方法的集合参数名和视图生成的name前缀一致，即可完成正常绑定：

[HttpPost]
public ActionResult GetSelectedCheckBoxes(List<Category> categories)
{
    var resultBuilder = new System.Text.StringBuilder();
    foreach (var category in categories)
    {
        string selectStatus = category.CheckboxAnswer ? "已选中" : "未选中";
        resultBuilder.AppendLine($"分类名称：{category.CategoryName}，选中状态：{selectStatus}");
    }
    return Content(resultBuilder.ToString());
}

特殊场景处理 #

如果必须使用非连续索引渲染集合项，需要额外为每个集合项添加名为[参数名].Index的隐藏域，值为当前项的自定义索引值，绑定器即可正确识别非连续的集合数据。

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