在 ASP.NET Core 中，[BindProperty] 是一种用于绑定模型属性的特性，通常与 Razor 页面配合使用。它会自动将请求中的表单数据绑定到页面模型的属性上，简化了手动从 Request.Form 或其他请求数据源获取数据的过程。

基本用法

1. 在 Razor 页面模型中使用 [BindProperty]

public class MyPageModel : PageModel
{
    // 使用 BindProperty 绑定输入数据
    [BindProperty]
    public string Name { get; set; }

    [BindProperty]
    public int Age { get; set; }

    public void OnGet()
    {
        // 在 GET 请求时做一些初始化工作
    }

    public IActionResult OnPost()
    {
        // 通过 BindProperty 绑定的属性会自动填充
        // 例如：通过 POST 请求发送表单数据后，Name 和 Age 就会被自动赋值

        if (ModelState.IsValid)
        {
            // 处理 POST 请求逻辑
            return Page();
        }
        return Page();
    }
}

2. Razor 页面上的表单

@page
@model MyPageModel

<h2>个人信息</h2>

<form method="post">
    <div class="form-group">
        <label for="name">姓名</label>
        <input type="text" id="name" asp-for="Name" class="form-control" />
    </div>
    
    <div class="form-group">
        <label for="age">年龄</label>
        <input type="number" id="age" asp-for="Age" class="form-control" />
    </div>
    
    <button type="submit" class="btn btn-primary">提交</button>
</form>

工作原理

1. [BindProperty] 让 ASP.NET Core 自动将请求中的值绑定到页面模型（PageModel）中的属性。在这个例子中，Name 和 Age 是通过表单提交的字段，[BindProperty] 确保它们的值会在提交时绑定到页面模型中。

2. 当表单提交时，OnPost 方法会自动调用。Name 和 Age 属性会被自动填充，因为 asp-for 标签帮助与 Razor 页面中的字段绑定。

额外的功能

• [BindProperty(SupportsGet = true)]： 默认情况下，[BindProperty] 只适用于 POST 请求，但如果你想让它也能处理 GET 请求的查询字符串数据，你可以通过设置 SupportsGet = true 来启用这一功能。

[BindProperty(SupportsGet = true)]
public string Name { get; set; }

• [BindProperty] 和 IActionResult：你可以根据需要从 OnPost 或 OnGet 方法返回不同的结果。例如，Page() 方法会返回当前页面，RedirectToPage() 方法可以重定向到另一个页面。

总结

[BindProperty] 是一种非常简便的方式来处理表单数据绑定，能够减少开发者在处理请求时的代码量，尤其是在处理 POST 请求时。