.NET中单选按钮组绑定模型时IsChecked值异常问题

问题根源 #

1. 视图中添加的<input type="hidden" name="Phrases[@i].IsChecked" value="false" />会和单选按钮的Phrases[i].IsChecked字段冲突，表单提交时隐藏字段的false会覆盖单选按钮的true值，导致后台接收的IsChecked全为false。
2. 手动设置统一的name="RequestStatus"会破坏ASP.NET Core的模型绑定规则，无法将选中状态映射到列表中对应项的IsChecked属性。

方法一：调整视图实现正确绑定（保持原有模型结构） #

修改视图代码，移除冲突的隐藏IsChecked字段，同时为同一类别的单选按钮设置动态name属性，确保组内互斥，且符合模型绑定要求：

@for (int i = 0; i < Model.Phrases.Count; i++)
{
    if (Model.Phrases[i].Category == "Request Status")
    {
        <div class="form-check form-check-inline">
            <input class="form-check-input"
                   type="radio"
                   asp-for="Phrases[i].IsChecked"
                   name="RequestStatusGroup"
                   value="true"
                   id="Phrase_@i" 
                   @(Model.Phrases[i].IsChecked ? "checked" : "")/>
            <label class="form-check-label" for="Phrase_@i">@Model.Phrases[i].Phrase</label>
        </div>
        <!-- 保留其他属性的隐藏字段 -->
        <input type="hidden" name="Phrases[@i].Id" value="@Model.Phrases[i].Id" />
        <input type="hidden" name="Phrases[@i].Category" value="@Model.Phrases[i].Category" />
        <input type="hidden" name="Phrases[@i].Phrase" value="@Model.Phrases[i].Phrase" />
    }
}

然后在后台Post方法中，手动将未选中的同类别项IsChecked设为false：

[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Create(RequestMaintenanceModel model)
{
    if (model.Phrases != null)
    {
        // 处理Request Status类别单选逻辑：确保只有选中项IsChecked为true
        var requestStatusPhrases = model.Phrases.Where(p => p.Category == "Request Status").ToList();
        var selectedOne = requestStatusPhrases.FirstOrDefault(p => p.IsChecked);
        foreach (var phrase in requestStatusPhrases)
        {
            phrase.IsChecked = phrase == selectedOne;
        }

        if (ModelState.IsValid)
        {
            _context.requestMaintenanceModel.Add(model);
            await _context.SaveChangesAsync();
            
            var selectedPhrases = model.Phrases.Where(p => p.IsChecked).ToList();
            foreach (var phrase in selectedPhrases)
            {
                phrase.RequestMaintenanceID = model.Id;
                _context.phraseModel.Add(phrase);
            }
            
            await _context.SaveChangesAsync();
            return RedirectToAction("Index");
        }
    }
    return View("Create", model);
}

方法二：新增属性简化绑定（推荐） #

这种方法更符合单选按钮组的设计逻辑，避免复杂的列表绑定：

1. 修改RequestMaintenanceModel，添加存储选中短语ID的属性：

public class RequestMaintenanceModel
{
    [ValidateNever]
    public int Id { get; set; }
    
    [ValidateNever]
    public List<PhraseModel> phraseModel { get; set; }
    public List<PhraseModel> Phrases { get; set; } = PhraseModel.PredefinedPhrases();
    
    // 新增：存储选中的Request Status短语ID
    public int SelectedRequestStatusId { get; set; }
}

2. 修改视图，绑定到新增的属性，确保单选组互斥：

@foreach (var phrase in Model.Phrases.Where(p => p.Category == "Request Status"))
{
    <div class="form-check form-check-inline">
        <input class="form-check-input"
               type="radio"
               asp-for="SelectedRequestStatusId"
               value="@phrase.Id"
               id="Phrase_@phrase.Id" />
        <label class="form-check-label" for="Phrase_@phrase.Id">@phrase.Phrase</label>
    </div>
    <!-- 保留所有短语的隐藏字段，确保模型回传时Phrases列表完整 -->
    <input type="hidden" name="Phrases[@Model.Phrases.IndexOf(phrase)].Id" value="@phrase.Id" />
    <input type="hidden" name="Phrases[@Model.Phrases.IndexOf(phrase)].Category" value="@phrase.Category" />
    <input type="hidden" name="Phrases[@Model.Phrases.IndexOf(phrase)].Phrase" value="@phrase.Phrase" />
}

3. 修改后台Post方法，根据选中ID设置对应IsChecked：

[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Create(RequestMaintenanceModel model)
{
    if (model.Phrases != null)
    {
        // 根据选中ID设置对应短语的IsChecked
        foreach (var phrase in model.Phrases)
        {
            phrase.IsChecked = phrase.Id == model.SelectedRequestStatusId && phrase.Category == "Request Status";
        }

        if (ModelState.IsValid)
        {
            _context.requestMaintenanceModel.Add(model);
            await _context.SaveChangesAsync();
            
            var selectedPhrases = model.Phrases.Where(p => p.IsChecked).ToList();
            foreach (var phrase in selectedPhrases)
            {
                phrase.RequestMaintenanceID = model.Id;
                _context.phraseModel.Add(phrase);
            }
            
            await _context.SaveChangesAsync();
            return RedirectToAction("Index");
        }
    }
    return View("Create", model);
}

关键说明 #

• 方法二的优势在于：单选按钮组的绑定更直观，符合HTML单选按钮的原生逻辑，同时避免了列表绑定带来的冲突问题。
• 无论哪种方法，都要移除视图中与单选按钮同名的隐藏IsChecked字段，防止值被覆盖。

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