ASP.NET MVC 5中局部视图输入值无法回传至主控制器的问题

这种情况我踩过好多次坑，核心问题基本都出在模型绑定的字段命名路径上，或者局部视图的调用方式不对，导致表单提交时，MVC的模型绑定器找不到对应的值。下面给你拆解原因和解决办法：

最常见的问题：局部视图的字段Name属性路径不对 #

MVC的模型绑定是靠表单字段的name属性来匹配ViewModel的属性的。如果你的局部视图直接用PartialViewModel作为模型，生成的字段name会是PartialField1这种短路径，但主ViewModel里这个属性是嵌套的（比如MainViewModel.PartialData.PartialField1），绑定器根本认不出来，自然不会赋值。

解决办法1：给局部视图指定字段前缀 #

调用局部视图的时候，通过ViewData传递字段前缀，让生成的input自动带上完整路径：

@Html.Partial("_你的局部视图名", Model.PartialData, new ViewDataDictionary(ViewData)
{
    TemplateInfo = new TemplateInfo { HtmlFieldPrefix = "PartialData" }
})

这里的PartialData就是主ViewModel里对应局部模型的属性名，这样局部视图里用Html.TextBoxFor生成的input，name会变成PartialData.PartialField1，绑定器就能正确匹配了。

解决办法2：用EditorFor代替Partial #

如果你的局部视图是用来编辑嵌套模型的，直接用@Html.EditorFor(m => m.PartialData)更省心——MVC会自动处理字段前缀，不需要手动设置，而且默认会找和模型同名的模板视图（比如PartialViewModel.cshtml放在Views/Shared/EditorTemplates里）。

手动写input的注意事项 #

如果你是手动写HTML input而不是用HtmlHelper，一定要手动指定完整的name属性：

<!-- 错误写法：name没有包含主模型的嵌套路径 -->
<input type="text" name="PartialField1" value="@Model.PartialData.PartialField1" />

<!-- 正确写法：name要对应主ViewModel的完整属性路径 -->
<input type="text" name="PartialData.PartialField1" value="@Model.PartialData.PartialField1" />

基础检查点：控件是否在表单范围内 #

别犯低级错误！确保局部视图里的所有输入控件都放在主视图的<form>标签内部，不然提交表单的时候这些字段根本不会被发送到服务器。

完整示例代码 #

模型类 #

public class MainViewModel
{
    public string MainTitle { get; set; }
    // 对应局部视图的嵌套模型属性
    public UserInfoPartialViewModel UserInfo { get; set; }
}

public class UserInfoPartialViewModel
{
    public string Username { get; set; }
    public int Age { get; set; }
}

主视图（Index.cshtml） #

@model MainViewModel

@using (Html.BeginForm("Save", "Home", FormMethod.Post))
{
    <div>
        @Html.LabelFor(m => m.MainTitle)
        @Html.TextBoxFor(m => m.MainTitle)
    </div>

    <!-- 调用局部视图并指定前缀 -->
    @Html.Partial("_UserInfoPartial", Model.UserInfo, new ViewDataDictionary(ViewData)
    {
        TemplateInfo = new TemplateInfo { HtmlFieldPrefix = "UserInfo" }
    })

    <button type="submit">保存</button>
}

局部视图（_UserInfoPartial.cshtml） #

@model UserInfoPartialViewModel

<div class="form-group">
    @Html.LabelFor(m => m.Username)
    @Html.TextBoxFor(m => m.Username, new { @class = "form-control" })
</div>
<div class="form-group">
    @Html.LabelFor(m => m.Age)
    @Html.TextBoxFor(m => m.Age, new { @class = "form-control" })
</div>

控制器方法 #

[HttpPost]
public ActionResult Save(MainViewModel model)
{
    // 现在model.UserInfo里就能拿到局部视图提交的值了
    if (ModelState.IsValid)
    {
        // 处理保存逻辑
        return RedirectToAction("Index");
    }
    // 验证失败返回原页面
    return View(model);
}

按照这个逻辑调整后，提交的数据应该就能正确绑定到主ViewModel的嵌套属性里了。

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