ASP.NET Core 6如何通过表单输入值设置模型属性传递至部分视图

问题场景 #

在Razor视图中传递嵌套模型给部分视图，表单内文本框、下拉框的用户输入提交后，后端接收到的始终是模型初始化的默认值，无法获取实际输入内容，对应视图代码如下：

@model ChartViewModel
@{
    ViewData["Title"] = "Charts";
}
@using (Html.BeginForm("Chart", "Chart", FormMethod.Get))
{
    var typeList = Html.GetEnumSelectList<TypeEnumeration>();
    @Html.TextBoxFor(model => model.ShowChartButtonDTO.SymbolId);
    @Html.DropDownListFor(model => model.ShowChartButtonDTO.TypeId,typeList);
    @Html.TextBoxFor(model => model.ShowChartButtonDTO.NearDate);
    @Html.TextBoxFor(model => model.ShowChartButtonDTO.FarDate);
    
    <partial name="_ShowChartButtonPartial" model="Model.ShowChartButtonDTO" />
}
@Html.Raw(Model.Renderer.RenderHtml())

常见遗漏点与修复方式 #

• 检查后端Action的模型绑定签名
  你当前表单使用FormMethod.Get提交，参数会拼接在URL查询字符串中，后端对应Chart Action必须直接接收ChartViewModel类型的入参，不要在Action内部手动new新的模型实例返回，否则模型绑定器填充的用户输入值会被你手动初始化的默认值覆盖。正确签名参考：

  public IActionResult Chart(ChartViewModel model)
  {
      // 直接使用绑定后的model做业务逻辑，不要重新初始化新实例
      return View(model);
  }
  

• 检查部分视图内的控件name前缀是否匹配绑定规则
  这是嵌套模型传部分视图的高频坑：如果你传入ShowChartButtonDTO的部分视图内部也渲染了SymbolId、TypeId这类输入控件，用Html.TextBoxFor(m => m.SymbolId)生成的控件name属性是SymbolId，缺少外层模型绑定要求的ShowChartButtonDTO.前缀，提交时会出现同名字段冲突，或者层级不匹配导致绑定失败。如果部分视图内有输入控件，要么直接在外层视图渲染所有输入字段，要么给部分视图指定HtmlFieldPrefix为ShowChartButtonDTO，保证控件name符合绑定层级要求。
• 检查是否存在同名字段重复渲染
  如果主视图和部分视图都渲染了同一属性的输入控件，表单提交时会携带多个同名参数，模型绑定器默认会取第一个匹配值，如果第一个值是默认空值，就会丢弃后面用户实际输入的内容，要保证每个表单字段只渲染一次。
• 检查GET提交的参数长度限制
  如果输入内容较长，GET请求的URL长度超过服务器/浏览器的限制，会导致参数被截断，部分字段值丢失，这种场景建议把表单提交方法改成FormMethod.Post。

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