为何绑定被‘禁止’？ASP.NET Core PageModel绑定问题排查

我为所有公共页面定义了一个公共基类PublicModel，代码如下：

public class PublicModel : PageModel
{
  [BindProperty]
  public BindingModel Input { get; set; }

  public partial class BindingModel
  {
    public string Username { get; set; }
    public string Password { get; set; }
  }
}

Index页面继承自该类：

public class IndexModel : PublicModel
{
  // Index page specific logic...
}

运行应用时，ParameterBinder输出调试信息：Skipped binding property 'IndexModel.Input' since its binding information disallowed it for the current request.，视图中仅使用了简单的标签助手：

<input asp-for="Input.Username" />

请问为何该绑定会被‘禁止’？

原因分析 #

在ASP.NET Core Razor Pages中，[BindProperty]特性默认仅对POST请求生效，针对GET请求会自动跳过属性绑定——这是框架默认的安全设计，用来避免过度绑定风险。如果你的Index页面是通过GET请求访问的（Razor Pages默认的页面访问方式就是GET），就会触发这条调试提示。

解决方案 #

根据业务需求选择以下方式：

1. 需要在GET请求中绑定属性：修改[BindProperty]特性，添加SupportsGet = true参数，允许GET请求绑定该属性：

   [BindProperty(SupportsGet = true)]
   public BindingModel Input { get; set; }
   

2. 仅在POST请求中使用绑定：确保页面表单的请求方法设置为post，比如在表单标签中添加method="post"，此时框架会正常处理POST请求的属性绑定，不会触发这条提示。

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