ASP.NET内部视图模型绑定到方法时参数值为null的问题

问题根源 #

当视图以CartViewModel为主模型，使用asp-for绑定内部的CartDeliveryDateViewModel（类型为CartDeliveryAndPaymentDetails）属性时，生成的表单字段name会带有层级前缀（比如CartDeliveryDateViewModel.DeliveryDate）。而后台方法直接接收CartDeliveryAndPaymentDetails类型参数时，模型绑定器无法匹配到对应字段，因此返回null。

解决方法 #

方法1：后台参数改为主视图模型 #

直接接收CartViewModel，从中提取内部模型属性，这是最直接的方式：

[HttpPost]
public IActionResult SaveDeliveryAndPaymentDetails(CartViewModel model)
{
    if (!ModelState.IsValid)
    {
        // 处理验证错误
        return View(model);
    }

    CartDeliveryAndPaymentDetails details = model.CartDeliveryDateViewModel;
    // 执行保存逻辑
    return RedirectToAction("CartSummary");
}

方法2：使用Bind特性指定前缀 #

保持后台参数为CartDeliveryAndPaymentDetails，通过[Bind(Prefix)]告知模型绑定器字段的前缀：

[HttpPost]
public IActionResult SaveDeliveryAndPaymentDetails([Bind(Prefix = "CartDeliveryDateViewModel")] CartDeliveryAndPaymentDetails details)
{
    if (!ModelState.IsValid)
    {
        // 注意：此时需要重新构建CartViewModel返回视图，避免丢失原有数据
        var cartModel = new CartViewModel { CartDeliveryDateViewModel = details };
        return View(cartModel);
    }

    // 执行保存逻辑
    return RedirectToAction("CartSummary");
}

方法3：调整视图字段的name属性（不推荐，适合少量字段） #

手动修改每个输入框的name，去掉层级前缀，让字段名直接匹配后台参数的属性名：

@model CartViewModel

<form asp-action="SaveDeliveryAndPaymentDetails" method="post">
    <input asp-for="CartDeliveryDateViewModel.DeliveryDate" name="DeliveryDate" />
    <input asp-for="CartDeliveryDateViewModel.PaymentMethod" name="PaymentMethod" />
    <button type="submit">保存</button>
</form>

关键检查点 #

• 确保CartDeliveryAndPaymentDetails的所有属性都是公共可读写的（带有get; set;），模型绑定需要访问这些属性。
• 检查ModelState.IsValid状态，如果为false，说明存在绑定错误（比如日期格式不匹配、必填项为空），可以通过ModelState.Values.SelectMany(v => v.Errors)查看具体错误信息。
• 如果使用部分视图渲染内部模型，必须指定HtmlFieldPrefix，确保生成的字段带有正确前缀：

<partial name="_DeliveryPaymentPartial" 
         model="Model.CartDeliveryDateViewModel" 
         view-data='new ViewDataDictionary(ViewData) { TemplateInfo = new TemplateInfo { HtmlFieldPrefix = "CartDeliveryDateViewModel" } }' />

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