ASP.NET Core 中的模型绑定是如何工作的？

模型绑定从路由、查询字符串、表单和请求体获取数据；简单类型从任意源匹配参数名，复杂类型递归绑定属性；JSON数据需用[FromBody]标记；绑定后自动验证 ModelState。

ASP.NET Core 中的模型绑定是将 HTTP 请求中的数据自动映射到控制器操作方法参数或其属性上的过程。它让开发者无需手动从请求中提取值，提升了开发效率和代码可读性。

模型绑定从哪些来源获取数据？

模型绑定会按优先级从多个数据源中查找匹配的值：

• 路由数据：来自路由模板中定义的参数，例如 /api/users/123 中的 id=123
• 查询字符串：URL 中的查询参数，如 ?name=john&age=30
• 请求体（Body）：通常用于 POST 或 PUT 请求，特别是 JSON 数据，需配合 [FromBody] 特性使用
• 表单数据：来自 HTML 表单提交的键值对，如 application/x-www-form-urlencoded

模型绑定如何处理简单类型和复杂类型？

根据操作方法参数的类型，模型绑定采取不同的策略：

• 对于 简单类型（如 int、string、DateTime），框架尝试从任意可用的数据源中查找同名字段。比如参数名为 id，就会检查路由、查询字符串等是否有 id 的值
• 对于 复杂类型（如自定义类），模型绑定会递归地为每个公共可写属性寻找值。例如一个 User 类有 Name 和 Email 属性，框架会尝试绑定 Name 和 Email 的值

什么时候需要 [FromBody]？

当客户端发送 JSON 数据时（如前端通过 fetch 发送对象），这类数据只能从请求体读取一次，不能像查询字符串那样重复读取。此时必须使用 [FromBody] 明确告诉模型绑定从此处读取：

天工大模型

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

115

查看详情

[HttpPost]
public IActionResult Create([FromBody] UserModel user)
{
    if (!ModelState.IsValid) return BadRequest(ModelState);
    // 处理 user 对象
    return Ok();
}

如果不加 [FromBody]，模型绑定会尝试从其他源找值，导致绑定失败。

模型验证与绑定结果

模型绑定完成后，框架会自动运行数据注解验证（如 [Required]、[EmailAddress]）。你可以通过 ModelState.IsValid 判断是否成功：

if (!ModelState.IsValid)
{
    return BadRequest(new { message = "输入数据无效", errors = ModelState });
}

未通过验证的字段和错误信息都会包含在 ModelState 中，便于返回给客户端。

基本上就这些。模型绑定简化了数据提取流程，只要命名一致、来源正确，大多数情况下都能自动完成。理解它的机制有助于调试绑定失败的问题，比如参数为空或格式错误。

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