这是msdn原文文档！明天用，留存。

Web API 控制器操作可以返回以下任何内容：

void

HttpResponseMessage

IHttpActionResult

其他类型

根据返回的这种情况，Web API 将使用不同的机制来创建 HTTP 响应。

返回类型
Web API 如何创建响应

void    返回空的204（无内容）  
HttpResponseMessage   直接转换为 HTTP 响应消息。  
IHttpActionResult   调用ExecuteAsync创建HttpResponseMessage，然后将其转换为 HTTP 响应消息。  
其他类型   将序列化的返回值写入响应正文;返回200（OK）。  

如果返回类型为void，Web API 只会返回一个空 HTTP 响应，状态代码为204（无内容）。

public class ValuesController : ApiController { public void Post() { } }

Http相应：

HTTP/1.1 204 No Content Server: Microsoft-IIS/8.0 Date: Mon, 27 Jan 2014 02:13:26 GMT

HttpResponseMessage

如果操作返回HttpResponseMessage，Web API 会将返回值直接转换为 HTTP 响应消息，并使用HttpResponseMessage对象的属性来填充响应。

此选项提供了对响应消息的大量控制。 例如，以下控制器操作设置缓存控制标头。

public class ValuesController : ApiController { public HttpResponseMessage Get() { HttpResponseMessage response = Request.CreateResponse(HttpStatusCode.OK, "value"); response.Content = new StringContent("hello", Encoding.Unicode); response.Headers.CacheControl = new CacheControlHeaderValue() { MaxAge = TimeSpan.FromMinutes(20) }; return response; } }

响应：

HTTP/1.1 200 OK Cache-Control: max-age=1200 Content-Length: 10 Content-Type: text/plain; charset=utf-16 Server: Microsoft-IIS/8.0 Date: Mon, 27 Jan 2014 08:53:35 GMT hello

Web API 2 中引入了IHttpActionResult接口。 实质上，它定义了HttpResponseMessage工厂。 下面是使用IHttpActionResult接口的一些优点：

简化控制器的单元测试。

将用于创建 HTTP 响应的公共逻辑移到单独的类中。

通过隐藏构造响应的低级别细节，使控制器操作的意图更清晰。

IHttpActionResult包含单一方法ExecuteAsync，它以异步方式创建HttpResponseMessage实例。

public interface IHttpActionResult { Task<HttpResponseMessage> ExecuteAsync(CancellationToken cancellationToken); }

如果控制器操作返回IHttpActionResult，Web API 将调用ExecuteAsync方法来创建HttpResponseMessage。 然后，将HttpResponseMessage转换为 HTTP 响应消息。

下面是创建纯文本响应的IHttpActionResult的简单实现：

public class TextResult : IHttpActionResult { string _value; HttpRequestMessage _request; public TextResult(string value, HttpRequestMessage request) { _value = value; _request = request; } public Task<HttpResponseMessage> ExecuteAsync(CancellationToken cancellationToken) { var response = new HttpResponseMessage() { Content = new StringContent(_value), RequestMessage = _request }; return Task.FromResult(response); } }

示例控制器操作：

public class ValuesController : ApiController { public IHttpActionResult Get() { return new TextResult("hello", Request); } }

响应：