ASP.NET Core 5 MVC Razor页面批量编辑实体列表数据绑定失效问题

核心问题根因 #

• 模型绑定前缀不匹配：ASP.NET Core 列表类型的模型绑定要求表单字段前缀和接收参数/属性的名称完全对应。你视图渲染的字段名格式为Customers[index].CustomerId，如果直接用[FromForm] List<Customer>接收，没有指定对应前缀，绑定系统无法匹配到对应字段，就会返回null。
• 未提交全量必填字段：你当前只提交了CustomerId字段，Name、City两个属性没有随表单提交，模型绑定会将这两个属性赋值为默认值，调用TryUpdateModelAsync更新数据库查询到的列表时，就会把原有列表的Name、City字段覆盖为空，看起来就像列表被清空。
• TryUpdateModelAsync未指定绑定前缀：调用该方法时如果没有显式指定和视图字段匹配的前缀Customers，系统会从根级查找字段，匹配不到对应值就会用默认值覆盖原有数据，同时因为没有绑定异常所以返回true。

修复方案 #

方案1：使用PageModel绑定属性（Razor Pages推荐） #

1. 在PageModel中定义带[BindProperty]特性的公共属性，属性名和视图字段前缀保持一致：

[BindProperty]
public List<Customer> Customers { get; set; }

2. 视图中补充隐藏域提交不需要编辑的字段，避免原有数据被覆盖：

@for (int i = 0; i < Model.Customers.Count; i++)
{
    <tr>
        <td>
            <input asp-for="Customers[i].CustomerId" type="number" />
            <!-- 补充隐藏域提交不可编辑字段 -->
            <input asp-for="Customers[i].Name" type="hidden" />
            <input asp-for="Customers[i].City" type="hidden" />
        </td>
    </tr>
}

3. 提交后直接访问Customers属性即可拿到完整的绑定数据，不需要额外调用TryUpdateModelAsync。

方案2：使用[FromForm]参数接收 #

显式指定参数绑定前缀和视图字段前缀匹配：

public async Task<IActionResult> OnPostAsync([FromForm(Name = "Customers")] List<Customer> customers)
{
    // 后续处理逻辑
}

方案3：修复TryUpdateModelAsync调用 #

调用时显式指定绑定前缀：

var dbCustomers = await _context.Customers.ToListAsync();
// 第二个参数传入和视图匹配的绑定前缀
await TryUpdateModelAsync(dbCustomers, "Customers");

注意事项 #

• 表单索引必须从0开始连续递增，不能出现跳号，否则跳号之后的所有数据都无法完成绑定。
• 所有需要保留的字段都必须随表单提交，要么作为可编辑字段，要么作为隐藏域，否则模型绑定会将未提交的字段赋值为默认值，覆盖原有数据。

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