03模型绑定 - ASP.NET Core WebAPI

---

一、模型绑定是什么？

微软定义：控制器处理来自 HTTP 请求的数据，模型绑定会自动化该过程。其中包括：

1. 从各种源（如路由数据、表单域和查询字符串）中检索数据
2. 将数据提供给方法参数和公共属性中的控制器
3. 将字符串数据转换为 .NET 类型
4. 更新复杂类型的属性

`个人理解：由于微软的定义是翻译的而且夹杂着razor，就抽取了部分比较清晰的内容。路由方法后就进行模型绑定，将HTTP请求数据转换为路由方法中的参数。

二、HTTP请求数据来源

默认情况下，模型绑定以键值对的形式从 HTTP 请求中的以下源中获取数据。（会按顺序进行获取）

1. 表单域
2. 请求正文（对于具有 [ApiController] 属性的控制器。）
3. 路由数据
4. 查询字符串参数
5. 上传的文件

特殊情况：

• 路由数据和查询字符串值仅用于简单类型。
• 上传的文件仅绑定到实现 IFormFile 或 IEnumerable< IFormFile > 的目标类型。

1.路由数据[FromRoute]

从路由数据中获取值。

代码如下（示例）：

 [HttpGet("{id}/{color}")]// 来自路由
 public string GetShirtsById(int id, [FromRoute]string color)
 {
     return $"Reading shirt with ID:{id}, color: {color}";
 }

请求结果：

2.查询字符串参数[FromQuery]

从查询字符串中获取值。

代码如下（示例）：

[HttpPost()] //来自字符串查询
public string CreateShirt([FromQuery]string color)
{
    return $"Creating a shirt, color: {color}";
}

请求结果：

3.HTTP 标头[FromHeader]

从 HTTP 标头中获取值。

代码如下（示例）：

[HttpPut()]// HTTP 标头
public string UpdateShirt([FromHeader]int id)
{
    return $"Updating shirt with ID:{id}";
}

请求结果：

---

4.请求正文[FromBody]

从 HTTP 标头中获取值。

代码如下（示例）：

[HttpPost] // 来自请求正文
public string CreateShirt([FromBody]Shirt shirt) 
{
    return $"Creating a shirt, id: {shirt.ShirtId}";
}

请求结果：

5.表单域[FromForm]

从发布的表单域中获取值。

代码如下（示例）：

[HttpPost] // 来自表单域
public string CreateShirt([FromForm] Shirt shirt)
{
    return $"Creating a shirt, id: {shirt.ShirtId}";
}

请求结果：

总结

路由数据和查询字符串值仅用于简单类型，表单域和HTTP 标头可以应用于复杂对象类型，请求正文用json可传输对象数组。