ASP.NET Core 中的页面模型如何绑定数据？

答案：ASP.NET Core Razor Pages通过绑定源特性自动将请求数据映射到属性或参数，支持FromQuery、FromForm、FromBody、FromRoute和FromHeader；需公共可写属性，常用BindProperty标记，结合ModelState验证确保数据正确性。

在 ASP.NET Core 的 Razor Pages 中，页面模型通过绑定机制自动将 HTTP 请求中的数据映射到页面类的属性或处理程序方法的参数上。这种机制简化了从前端接收数据的过程，无需手动解析请求内容。

使用绑定源特性指定数据来源

ASP.NET Core 提供了多种绑定源特性，用于明确指定数据应从请求的哪个部分读取：

• [FromQuery]：从 URL 查询字符串中获取值
• [FromForm]：从表单正文中提取数据（常见于 POST 请求）
• [FromBody]：从 JSON 请求体中反序列化对象（通常用于 API 风格请求）
• [FromRoute]：从路由模板中提取参数（如 /users/123 中的 123）
• [FromHeader]：从 HTTP 请求头中读取信息

这些特性可以应用于页面模型中的公共属性或处理程序方法的参数。

模型绑定如何工作

当请求到达时，运行时会根据属性名称或参数名匹配请求中的键名（不区分大小写），并尝试转换类型。例如，前端提交一个名为 Name 的表单字段，页面模型中定义的 public string Name { get; set; } 会被自动赋值。

支持复杂类型和集合绑定。如果模型包含嵌套对象或数组，只要命名正确（如使用点号或索引表示法），框架也能正确解析。

常见场景包括：

• 用户注册表单提交时，[FromForm] 绑定整个用户模型
• 分页请求中用 [FromQuery] 接收页码和每页数量
• RESTful 操作中通过 [FromRoute] 获取资源 ID

启用绑定的属性需满足条件

只有公共、可写属性才能参与模型绑定。私有属性或只读属性不会被设置。建议使用 [BindProperty] 特性显式标记需要绑定的属性，尤其是处理 POST 请求时。

天工大模型

中国首个对标ChatGPT的双千亿级大语言模型

115

查看详情

例如：

[BindProperty]
public string Email { get; set; }

这样即使没有指定绑定源，默认也会从表单中查找同名字段。若希望 GET 请求也能绑定，可加上模式参数：[BindProperty(SupportsGet = true)]。

验证与错误处理

绑定完成后，可通过 ModelState.IsValid 判断是否成功。失败通常是因为类型不匹配或验证特性（如 [Required]、[StringLength]）未通过。

开发时应始终检查 ModelState 状态，避免处理无效数据：

if (!ModelState.IsValid)
{
    return Page();
}

此时 Razor 页面会保留输入值并显示验证错误信息。

基本上就这些。只要命名一致、特性正确，ASP.NET Core 能自动完成大部分数据传递工作。关键是理解不同绑定源的使用场景，并合理使用特性控制行为。不复杂但容易忽略细节。

以上就是ASP.NET Core 中的页面模型如何绑定数据？的详细内容，更多请关注php中文网其它相关文章！