ASP.NET MVC 级联关系表单的非连续主键索引模型绑定实现

核心实现逻辑 #

ASP.NET Core 内置模型绑定对字典类型的绑定规则天然适配非连续的索引场景：只要表单字段名遵循[属性名][键值]的格式，无论键值是否连续、是否从0起始，绑定器都会自动将键值映射为字典的键，对应字段值映射为字典的value，完全不需要自定义绑定逻辑。

入参模型设计 #

不要直接使用原领域实体类作为接口入参，专门设计适配表单提交的视图模型即可：

/// <summary>
/// 表单提交根模型
/// </summary>
public class SpecificationSubmissionRoot
{
    // 键：对应表单名中 [SpecificationId] 的值，直接保留规格实体主键
    public Dictionary<int, FeatureSubmissionItem> Specifications { get; set; } = new();
}

/// <summary>
/// 单个规格下的特性提交项
/// </summary>
public class FeatureSubmissionItem
{
    // 键：对应表单名中 [FeatureId] 的值，直接保留特性实体主键
    public Dictionary<int, FeatureValueSubmissionItem> Feature { get; set; } = new();
}

/// <summary>
/// 单个特性下的选中值提交项
/// </summary>
public class FeatureValueSubmissionItem
{
    // 兼容单选/多选场景：multiple选择器会提交多个同名字段，数组可正常接收
    public int[] FeatureValues { get; set; } = Array.Empty<int>();
}

关键适配说明 #

• 原实体类中ICollection<T>的集合结构是导致绑定失败的核心原因：内置集合绑定器只识别从0开始的连续索引，遇到非连续的实体主键作为索引时，会直接跳过非匹配项，既无法填充对应属性，也拿不到中括号内的主键值。
• 字典结构完全匹配现有前端的命名规则：不需要修改Razor视图生成的select名称，也不需要调整AJAX提交的序列化逻辑，内置表单编码格式（application/x-www-form-urlencoded）可以被绑定器正常解析。
• 绑定完成后可直接从字典键中提取需要保留的实体主键，无需额外解析原始请求内容，满足后续数据存储的关联匹配需求。

服务端使用示例 #

[HttpPost]
public async Task<IActionResult> SaveSubmission([FromForm] SpecificationSubmissionRoot model)
{
    // 遍历所有提交的规格项
    foreach (var specPair in model.Specifications)
    {
        int specId = specPair.Key; // 直接获取规格实体主键
        var featureDict = specPair.Value.Feature;

        // 遍历当前规格下的所有特性项
        foreach (var featurePair in featureDict)
        {
            int featureId = featurePair.Key; // 直接获取特性实体主键
            int[] selectedValueIds = featurePair.Value.FeatureValues; // 获取选中的特性值ID集合

            // 后续直接使用三个ID完成关联数据的存储逻辑
        }
    }

    return Ok();
}

注意：如果存在单选/多选的兼容场景，FeatureValues属性必须使用数组类型，单个选中值会被自动填充到数组的首个元素位置，不会因为是单选场景触发绑定异常。

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