在 ASP.NET Core MVC 中，接收数据的几种方式

在 ASP.NET Core MVC 中，接收数据本质靠「模型绑定（Model Binding）」，根据数据来源和 Content-Type 不同，有多种标准写法。下面按最常见的使用场景系统梳理。

---

一、按「数据来源」划分的接收方式

1️⃣ 从 URL（Query / Route）接收

✅ Query 参数（?id=1）

csharp

csharp

 

public IActionResult GetUser(int id)
{
    return Ok(id);
}

或显式声明：

csharp

csharp

 

public IActionResult GetUser([FromQuery] int id)

📌 适用于：GET请求

---

✅ Route 参数（/user/1）

csharp

csharp

 

[HttpGet("user/{id}")]
public IActionResult GetUser(int id)
{
    return Ok(id);
}

显式写法：

csharp

csharp

 

public IActionResult GetUser([FromRoute] int id)

---

2️⃣ 从请求体（Body）接收

✅ JSON（application/json）→ [FromBody]

👉 前后端分离最常用

csharp

csharp

 

public record UserDto(string Name, int Age);

[HttpPost]
public IActionResult CreateUser([FromBody] UserDto user)
{
    return Ok(user);
}

前端示例：

js

js

 

fetch('/api/user', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'tom', age: 18 })
});

⚠️ 注意：

• 一个 Action 只能有一个 [FromBody]

• 必须是 application/json

---

✅ 表单（application/x-www-form-urlencoded）

csharp

csharp

 

public IActionResult Login([FromForm] string username, [FromForm] string password)

或绑定到模型：

csharp

csharp

 

public class LoginVm
{
    public string Username { get; set; }
    public string Password { get; set; }
}

[HttpPost]
public IActionResult Login(LoginVm vm)

📌 前端对应：

js

js

 

const params = new URLSearchParams();
params.append("username", "tom");
params.append("password", "123");

fetch("/login", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: params
});

---

✅ 文件上传（multipart/form-data）

csharp

csharp

 

[HttpPost]
public async Task<IActionResult> Upload(IFormFile file)
{
    using var stream = file.OpenReadStream();
    // 保存文件
    return Ok();
}

多个文件：

csharp

csharp

 

public async Task<IActionResult> Upload(List<IFormFile> files)

配合 FormData：

csharp

csharp

 

const formData = new FormData();
formData.append("file", input.files[0]);

✅ 不能用 [FromBody]

---

3️⃣ 混合来源（推荐做法）

csharp

csharp

 

[HttpPost("user/{id}")]
public IActionResult UpdateUser(
    [FromRoute] int id,
    [FromQuery] string source,
    [FromBody] UserDto user)

---

二、按「参数绑定特性」速查表

 

特性	数据来源	常见 Content-Type
默认	Query / Form	-
[FromRoute]	URL 路径	-
[FromQuery]	URL 查询字符串	-
[FromBody]	Request Body	application/json
[FromForm]	Form 表单	application/x-www-form-urlencoded/ multipart/form-data
[FromHeader]	请求头	-
[FromServices]	依赖注入	-

---

三、模型绑定常见规则

✅ 属性名匹配（不区分大小写）

json

json

 

{ "name": "Tom" }

可绑定到：

csharp

csharp

 

public string Name { get; set; }

✅ 复杂对象 + 集合

json

json

 

{
  "name": "Tom",
  "skills": ["C#", "Java"]
}

csharp

csharp

 

public record UserDto(string Name, List<string> Skills);

✅ 自定义绑定（高级）

• IModelBinder

• [ModelBinder(typeof(...))]

---

四、常见坑 & 排查点

❌ JSON 用 [FromForm]

→ 永远拿不到值

❌ [FromBody]用两次

→ 运行时异常

❌ 文件上传却用 JSON

→ IFormFile为 null

✅ 想接表单又想接 JSON？

→ 不行，一个 Action 只能选一种 Body 绑定方式

---

五、一句话选型建议

 

场景	推荐方式
REST API	[FromBody] + JSON
传统 MVC 表单	默认绑定 / [FromForm]
文件上传	IFormFile + multipart
GET 查询	[FromQuery]
RESTful 资源	[FromRoute]