BindProperty绑定对象失效：表单提交时对象属性无法正确回传

我实现了表单提交功能，绑定了四个属性：一个string类型、一个int类型，另外两个为自定义类对象。后端代码如下：

[BindProperty]
public PortfolioModel Portfolio { get; set; }
[BindProperty]
public StockModel Stock { get; set; }
[BindProperty]
public string StockSymbol { get; set; }
[BindProperty]
public int QuantityToTrade { get; set; }

这些属性在OnGetAsync()中已被正确赋值，调试时数据正常。前端表单代码如下：

<form method="post">
    <div>
        Qty. <input type="text" name="QuantityToTrade" id="QuantityToTrade" /> 
        <input type="hidden" asp-for="@Model.StockSymbol" />
        <input type="hidden" asp-for="@Model.Stock" />
        <input type="hidden" asp-for="@Model.Portfolio" />
        <input class="btn-primary" type="submit" value="Buy" asp-page-handler="Buy" />
        <input class="btn-primary" type="submit" value="Sell" asp-page-handler="Sell" />
    </div>
</form>

提交表单后，在OnPostBuyAsync()方法中，StockSymbol和QuantityToTrade的值正确，但Portfolio和Stock的整数字段均为0，其他字段为null。已排除属性setter为私有这个常见原因，想知道为什么类对象无法正确回传？

原因及解决方法 #

核心原因 #

使用asp-for="@Model.Stock"或asp-for="@Model.Portfolio"生成隐藏输入时，Razor只会渲染一个name为Stock/Portfolio的输入框，其值是类的默认ToString()结果（通常是类的完全限定名），而非对象的各个属性值。ASP.NET Core的模型绑定器无法将这个字符串解析成完整的自定义类对象，因此会创建一个该类的空实例，整型字段默认值为0，引用类型字段为null。

解决方法 #

• 方法一：逐个绑定类的属性
  为自定义类的每个需要回传的属性单独生成隐藏输入，比如：

  <!-- Stock类的属性示例 -->
  <input type="hidden" asp-for="@Model.Stock.Id" />
  <input type="hidden" asp-for="@Model.Stock.Symbol" />
  <input type="hidden" asp-for="@Model.Stock.Price" />
  
  <!-- Portfolio类的属性示例 -->
  <input type="hidden" asp-for="@Model.Portfolio.Id" />
  <input type="hidden" asp-for="@Model.Portfolio.Name" />
  

  这样表单提交时，每个属性的值都会被单独传递，模型绑定器能正确组装出完整的对象。

• 方法二：仅传递标识，后端重新获取对象
  如果业务上只需要类的唯一标识（比如ID），不需要传递所有属性，只需在表单中传递ID：

  <input type="hidden" asp-for="@Model.Stock.Id" />
  <input type="hidden" asp-for="@Model.Portfolio.Id" />
  

  然后在OnPostBuyAsync()方法中，通过ID从数据库或其他数据源重新查询获取完整的Stock和Portfolio对象。这种方式更安全，避免前端篡改对象属性值。

• 方法三：使用临时存储（不推荐）
  可以将Stock和Portfolio对象存入TempData或Session中，在Post方法中直接取出：

  // OnGetAsync中存储
  TempData["Stock"] = Stock;
  TempData["Portfolio"] = Portfolio;
  
  // OnPostBuyAsync中取出（需确保类可序列化）
  var stock = TempData["Stock"] as StockModel;
  var portfolio = TempData["Portfolio"] as PortfolioModel;
  

  注意：对象必须实现ISerializable或标记为[Serializable]，且这种方式只适合小数据量，不建议用于复杂或大型对象。

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