ASP.NET MVC传递子属性到分部视图后模型绑定失败问题

核心问题 #

分部视图使用子模型时，生成的表单字段name属性缺少主模型的父级前缀（如AddressDetails.），导致MVC无法将字段值映射到主模型的子属性。

可行解决方案 #

1. 调用分部视图时指定字段前缀 #

在主视图中调用分部视图时，通过ViewDataDictionary传递HtmlFieldPrefix，让分部视图生成的控件自动带上父级前缀：

主视图代码：

@model CareHomes

@using (Html.BeginForm())
{
    <!-- 其他主模型字段 -->
    @Html.Partial("_AddressDetails", Model.AddressDetails, new ViewDataDictionary(ViewData) {
        TemplateInfo = new TemplateInfo { HtmlFieldPrefix = "AddressDetails" }
    })

    @Html.Partial("_ContactDetails", Model.ContactDetails, new ViewDataDictionary(ViewData) {
        TemplateInfo = new TemplateInfo { HtmlFieldPrefix = "ContactDetails" }
    })

    <input type="submit" value="提交" />
}

分部视图_AddressDetails.cshtml代码（模型为AddressDetails）：

@model AddressDetails

<div>
    @Html.LabelFor(m => m.Postcode)
    @Html.TextBoxFor(m => m.Postcode)
    @Html.ValidationMessageFor(m => m.Postcode)
</div>
<!-- 其他AddressDetails字段 -->

这样生成的input标签name属性会是AddressDetails.Postcode，提交后MVC能正确绑定到CareHomes.AddressDetails.Postcode。

2. 使用EditorTemplate自动处理前缀 #

创建对应子模型的EditorTemplate，MVC会自动为生成的控件添加父级前缀：

1. 在Views/Shared/EditorTemplates目录下创建AddressDetails.cshtml（文件名需与子模型类名一致）：

@model AddressDetails

<div>
    @Html.LabelFor(m => m.Postcode)
    @Html.TextBoxFor(m => m.Postcode)
    @Html.ValidationMessageFor(m => m.Postcode)
</div>
<!-- 其他AddressDetails字段 -->

2. 主视图中使用EditorFor调用模板：

@model CareHomes

@using (Html.BeginForm())
{
    <!-- 其他主模型字段 -->
    @Html.EditorFor(m => m.AddressDetails)
    @Html.EditorFor(m => m.ContactDetails)

    <input type="submit" value="提交" />
}

这种方式更符合MVC的约定优于配置原则，无需手动指定前缀，复用性更强。

3. 手动指定字段name（不推荐） #

如果不想修改分部视图的调用方式，可以在分部视图中手动为控件指定带前缀的name属性：

@model AddressDetails

<div>
    @Html.Label("AddressDetails.Postcode", "邮编")
    @Html.TextBox("AddressDetails.Postcode", Model.Postcode)
    @Html.ValidationMessage("AddressDetails.Postcode")
</div>

这种方式灵活性差，子模型字段变更时需要同步修改前缀，适合临时场景。

注意事项 #

• 确保分部视图中的表单控件嵌套在主视图的Html.BeginForm内部，不要在分部视图中单独使用Html.BeginForm，避免表单嵌套或提交范围错误。
• 如果使用数据注解验证，确保分部视图中的验证信息能正确关联到主模型的子属性，前两种方案会自动处理验证，第三种需要手动指定验证消息的键。

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