ASP.NET MVC Razor页面Post方法如何获取未勾选Checkbox状态

首先明确核心原因：浏览器提交表单时，只会发送处于勾选状态的Checkbox值，未勾选的不会被包含在请求数据里，这是HTTP表单的默认行为，所以你现在只能拿到已勾选的ID数组。

下面给两种实用的解决方法：

方法一：后端预设所有模块ID，对比已勾选列表（改动最小） #

如果你的模块ID是固定或可以提前获取的（比如从数据库读取所有模块ID），直接在Post方法里用所有模块ID减去已勾选的ID，剩下的就是未勾选的。

代码调整： #

1. 先修正视图里的错误：去掉每个Checkbox的asp-for="UserAccess.MODULECODE"（这个绑定的是单个UserAccess对象的MODULECODE，和你要绑定到数组的需求冲突），修改后的视图Checkbox代码：

<input id="StockTake" name="UserAccessViewModel.checks" type="checkbox" value="1">
<input id="ShelfLabelPrint" name="UserAccessViewModel.checks" type="checkbox" value="2">
<input id="Transfer" name="UserAccessViewModel.checks" type="checkbox" value="3">
<!-- 另外两个Checkbox同理，value设为4、5 -->

2. 在PageModel里实现对比逻辑：

// 假设所有模块ID是固定的，或者从数据库动态获取
private readonly List<int> _allModuleIds = new List<int> { 1, 2, 3, 4, 5 };

public async Task OnPost(UserAccessViewModel UserAccessViewModel)
{
    // 处理已勾选数组为空的情况，避免空引用
    var checkedIds = UserAccessViewModel.checks ?? Array.Empty<int>();
    // 用所有模块ID减去已勾选ID，得到未勾选列表
    var uncheckedModuleIds = _allModuleIds.Except(checkedIds).ToList();

    // 这里就可以使用uncheckedModuleIds做后续处理了
}

如果模块ID是动态从数据库获取的，Post时需要重新读取所有模块ID（因为PageModel的属性在Post时不会自动保留）：

public async Task OnPost(UserAccessViewModel UserAccessViewModel)
{
    // 从数据库获取所有模块ID
    var allModuleIds = await _moduleRepository.GetAllModuleIdsAsync();
    var checkedIds = UserAccessViewModel.checks ?? Array.Empty<int>();
    var uncheckedModuleIds = allModuleIds.Except(checkedIds).ToList();
}

方法二：为每个Checkbox添加隐藏字段，强制提交所有状态 #

这种方法让前端不管Checkbox是否勾选，都提交对应的状态值，后端可以直接拿到每个模块的勾选情况。

步骤： #

1. 重构ViewModel，改用字典存储每个模块的勾选状态：

public class UserAccessViewModel
{
    public UserAccess userAccess { get; set; }
    // 键是模块ID，值是是否勾选
    public Dictionary<int, bool> ModuleAccess { get; set; } = new Dictionary<int, bool>();
}

2. 在PageModel的OnGet方法中初始化所有模块的勾选状态（默认未勾选）：

public List<int> AllModuleIds { get; set; }

public async Task OnGet()
{
    // 获取所有模块ID（固定或从数据库读取）
    AllModuleIds = new List<int> { 1, 2, 3, 4, 5 };
    // 初始化字典，默认所有模块未勾选
    foreach (var id in AllModuleIds)
    {
        UserAccessViewModel.ModuleAccess.Add(id, false);
    }
}

3. 视图中循环渲染Checkbox和对应的隐藏字段：

@Html.AntiForgeryToken()
<form method="post">
<button id="FillCheckBox" type="submit" class="col-sm-1 btn btn-primary">Submit</button>

@foreach (var moduleId in Model.AllModuleIds)
{
    <!-- 隐藏字段：未勾选时提交false -->
    <input type="hidden" asp-for="UserAccessViewModel.ModuleAccess[@moduleId]" value="false" />
    <!-- Checkbox：勾选时提交true，会覆盖隐藏字段的值 -->
    <input id="Module_@moduleId" type="checkbox" asp-for="UserAccessViewModel.ModuleAccess[@moduleId]" value="true" />
    <label for="Module_@moduleId">@GetModuleName(moduleId)</label>
    <!-- 这里需要自己实现GetModuleName方法，根据ID返回模块名称 -->
}
</form>

4. Post方法中直接获取未勾选列表：

public async Task OnPost(UserAccessViewModel UserAccessViewModel)
{
    // 筛选出所有未勾选的模块ID
    var uncheckedModuleIds = UserAccessViewModel.ModuleAccess
        .Where(kv => !kv.Value)
        .Select(kv => kv.Key)
        .ToList();

    // 后续处理逻辑
}

两种方法对比 #

• 方法一：改动最小，适合只需要获取未勾选列表的场景；
• 方法二：更灵活，能明确获取每个模块的勾选状态，适合需要回显表单或逐个处理模块的场景。

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