WebApi POST 可以在没有 [FromBody] 的情况下工作吗？

Question

我有这个控制器动作：

 [HttpPost]
 [ActionName("aaa")]
 public HttpResponseMessage aaa(Z z) //notice  - no [FromBody]
 {
    return Request.CreateResponse(HttpStatusCode.OK, 1);  
 }

Z 在哪里：

public class Z
 {
   public string a { get; set; }
 }

但是当我通过提琴手发帖时：

POST http://localhost:11485/api/profiles/aaa HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Host: localhost:11485
Content-Length: 3
Accept-Encoding: gzip, deflate
Accept-Language: en-US,en;q=0.8,he;q=0.6
Cache-Control: no-cache
Connection: keep-alive

a=1

我实际上可以看到它正在工作：

问题：

如果是这样，如果没有 [FromBody] 属性，它如何工作？我还需要/不写这个属性吗？

另外，什么情况下不写这个属性会导致问题？

Answer 1

MVC 和 Web API 的绑定是不同的。默认情况下，ASP.NET Web API 绑定来自请求消息正文的复杂类型和来自 URI、查询字符串等的简单类型。由于您指定了 Z，它是一个类（复杂类型），它从正文，无需指定 [FromBody]。另一方面，如果您的请求是没有正文的http://localhost:11485/api/profiles/aaa?z=1，它不会自动绑定到您的复杂参数。在这种情况下，您需要像这样指定[FromUri]：public HttpResponseMessage aaa([FromUri]Z z)。

另一方面，假设您的操作方法是public HttpResponseMessage aaa(string a)。我们现在有了string，这是一个简单的类型。在这种情况下，没有消息正文的http://localhost:11485/api/profiles/aaa?a=1 将使Web API 正确绑定参数，而无需指定[FromUri]。现在，如果你想在这种情况下从正文绑定，你需要指定public HttpResponseMessage aaa([FromBody]string a)。当然，对于这个body必须是=1，对于application/x-www-form-urlencoded，没有a的键名。

底线 - 您的参数（简单类型或复杂类型）决定了 Web API 的绑定方式。要使其与默认行为不同，您需要通过FromUri 或FromBody 告知。

PS。我上面提到的任何东西都适用于旧的 ASP.NET Web API（包括 2）。在 ASP.NET 5.0 又名 ASP.NET vNext 或 ASP.NET MVC 6.0 中，MVC 和 Web API 已经统一。为了让它从body中绑定一个复杂类型，你必须指定[FromBody]。