官术网_书友最值得收藏!

IActionResult and ActionResult<T>

The IActionResult interface defines the contract <indexentry content="HTTP response:ActionResult"> for action method responses. The default implementation of the interface is provided by the ActionResult and ActionResult<T> types, but ASP.NET Core provides many derived response types that you can use to fully control the HTTP response that will be generated. Here is a short list of some of them:

  • EmptyResult: Generates an HTTP response with a success status code (200 OK) and an empty body.
  • ObjectResult: Generates a response with a body, where the body is a serialization of an object you provide. The object is serialized to the content type that was requested by the client. 
  • BadRequestResult: Generates a response with a BadRequst status code (400) that signals to the client that the given request is invalid.
  • ViewResult: Allows you to render a view, from a cshtml file, for example, and return the result (as HTML) to the client.
  • FileResult: Generates a response that contains file data. There are derived classes for various file reading formats.
  • RedirectResult: Generates a response with a temporary redirect (302) or permanent redirect status code (301) that contains the URL to navigate to.

Starting from ASP.NET Core 2.1, the ActionResult<T> type can be used as the return type of a controller action to make it explicit what the type of the body will be in a successful response, while still allowing for the return of other response types if needed. 

When an action with an explicit predefined return type returns its result, ASP.NET Core wraps the returned value in an ObjectResult instance.

For example, if GiveNTake receives a request to add a product with invalid request data, we send the client a BadRequestResult, and if the request was valid, we echo the request data with an ObjectResult, like this: 

[HttpPost("")]
public ActionResult<NewProductDTO> AddNewProduct([FromBody] NewProductDTO newProduct)
{
if (!ModelState.IsValid)
{
return new BadRequestResult();//(ModelState);
}
return newProduct;
}
主站蜘蛛池模板: 柳江县| 乐山市| 拜城县| 巢湖市| 湘阴县| 怀宁县| 海林市| 朝阳市| 安仁县| 宁夏| 筠连县| 客服| 巢湖市| 枞阳县| 如皋市| 茌平县| 建水县| 陈巴尔虎旗| 黎川县| 盐山县| 兴国县| 昌吉市| 内乡县| 岳池县| 阳朔县| 泰顺县| 大丰市| 西宁市| 望江县| 育儿| 玉树县| 商河县| 博罗县| 嘉黎县| 双城市| 当涂县| 罗田县| 闵行区| 吉林省| 永安市| 互助|