ASP.NET MVC Razor页面回发时字典绑定下拉列表选中值丢失

核心问题原因 #

• 自定义键类型（如CountryCode枚举/自定义类）的Dictionary，ASP.NET MVC默认模型绑定器无法正确解析回发的表单值
• 回发时ModelState会优先读取原始提交值，但如果表单控件命名不符合绑定规则，会导致选中值丢失；且SelectList的选中状态不会自动保留，需重新赋值

推荐解决方案：改用List类型ViewModel（绑定更稳定） #

1. 定义ViewModel #

public class CountrySelectViewModel
{
    public CountryCode Code { get; set; } // 你的CountryCode枚举/类型
    public string SelectedCountryId { get; set; } // 存储选中的国家ID
    public SelectList CountryOptions { get; set; } // 下拉选项列表
}

2. 调整Controller逻辑 #

GET请求（初始化页面）

public ActionResult Index()
{
    var model = new List<CountrySelectViewModel>();
    // 遍历所有CountryCode，初始化每个下拉的选项与默认选中值
    foreach (CountryCode code in Enum.GetValues(typeof(CountryCode)))
    {
        var countryList = GetAllCountries(); // 你的获取国家列表方法
        // 根据业务逻辑设置默认选中项
        var defaultSelectedId = countryList.FirstOrDefault(c => c.IsDefault)?.Id;
        
        model.Add(new CountrySelectViewModel
        {
            Code = code,
            SelectedCountryId = defaultSelectedId,
            CountryOptions = new SelectList(countryList, "Id", "Name", defaultSelectedId)
        });
    }
    return View(model);
}

POST请求（处理回发）

[HttpPost]
public ActionResult Index(List<CountrySelectViewModel> model)
{
    if (!ModelState.IsValid)
    {
        // 回发时重新加载下拉选项（模型绑定不会保留SelectList）
        foreach (var item in model)
        {
            var countryList = GetAllCountries();
            item.CountryOptions = new SelectList(countryList, "Id", "Name", item.SelectedCountryId);
        }
        return View(model);
    }
    
    // 处理业务逻辑（如保存选中值）
    return RedirectToAction("Success");
}

3. 修改Razor视图代码 #

用for循环遍历List（支持索引绑定，模型绑定器能正确识别）：

@model List<CountrySelectViewModel>

@using (Html.BeginForm())
{
    for (int i = 0; i < Model.Count; i++)
    {
        <div class="form-group">
            @Html.LabelFor(m => m[i].Code)
            @Html.HiddenFor(m => m[i].Code) <!-- 隐藏域保存CountryCode，避免回发丢失 -->
            @Html.DropDownListFor(m => m[i].SelectedCountryId, Model[i].CountryOptions, "请选择国家", new { @class = "form-control" })
            @Html.ValidationMessageFor(m => m[i].SelectedCountryId)
        </div>
    }
    <button type="submit" class="btn btn-primary">提交</button>
}

坚持用Dictionary的替代方案（不推荐，绑定稳定性差） #

1. 调整模型为字符串键的Dictionary #

public class CountrySelectItem
{
    public string SelectedCountryId { get; set; }
    public SelectList CountryOptions { get; set; }
}

// 控制器中使用Dictionary<string, CountrySelectItem>，把CountryCode转成字符串作为键

2. Razor视图代码（手动指定表单控件name属性） #

@model Dictionary<string, CountrySelectItem>

@using (Html.BeginForm())
{
    foreach (var kvp in Model)
    {
        <div class="form-group">
            @Html.Label(kvp.Key)
            <!-- 手动设置name属性，确保模型绑定器能识别 -->
            @Html.DropDownList($"[{kvp.Key}].SelectedCountryId", kvp.Value.CountryOptions, "请选择国家", new { @name = $"[{kvp.Key}].SelectedCountryId", @class = "form-control" })
            <input type="hidden" name="Keys" value="@kvp.Key" /> <!-- 保存键值 -->
        </div>
    }
    <button type="submit" class="btn btn-primary">提交</button>
}

关键注意事项 #

• 回发时必须重新加载SelectList选项，模型绑定不会自动保留该对象
• 优先使用DropDownListFor而非DropDownList，它会自动从ModelState/Model中读取选中值，无需手动设置Selected属性
• 避免用自定义类型作为Dictionary的键，模型绑定器对字符串/数值类型键的支持更可靠

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