对于 MVC
视图应用而言,Action 返回的结果通常是一个 View
,即页面;
而对于 Web API
应用程序来说,则返回相应的资源
或者 HTTP 状态码
。
Controller
根据约定,继承自位于 Microsoft.AspNetCore.Mvc
命名空间下的 Controller 类,而这个 Controller 类又继承自 ControllerBase
抽象类。
如果一个类并不满足上述约定,那么只要为它添加[Controller]
特性,仍然能够将它作为 Controller 处理;反之,如果为一个 Controller 添加[NotController]特性。
[Controller]
public class Blogs
{
}
[NonController]
public class ValueController
{
}
Action
每个 Action 都应返回 IActionResult
类型或ActionResult<T>
类型的值作为 HTTP 请求的结果。
常见的类别,包括
- 状态码
- 对象的状态码
- 重定向
- 内容
状态码
返回一个 HTTP 状态码给客户端
对应的状态码 | 描述 | ControllerBase中的方法 |
---|---|---|
200 | 操作成功 | Ok() |
400 | 错误的请求 | BadRequest() |
204 | 操作成功,但未返回任何内容 | NoContent() |
404 | 请求的资源找不到 | NotFound() |
401 | 未授权 | Unauthorized() |
415 | 无法处理请求附带的媒体格式 | 无 |
如果要返回上述状态码之外的结果,则可以使用 StatusCode
方法,并为该方法指明具体的状态码。
return StatusCode(403);
直接使用状态码数字有可能会出错,更简单且直观的方法是,使用Microsoft.AspNetCore.Http
命名空间下的 StatusCodes
静态类
return StatusCode(Microsoft.AspNetCore.Http.StatusCodes.Status200OK);
对象的状态码
这一类结果继承自 ObjectResult
,包括 OkObjectResult
、CreatedResult
和 NotFoundObjectResult
等。
public IActionResult DoSomething()
{
var result = new OkObjectResult(new { message = "success", currentDate = DateTime.Now});
return result;
}
重定向
包括 RedirectResult
、LocalRedirectResult
、RedirectToActionResult
和 RedirectToRouteResult
等。
// 重定向到指定的URL
return Redirect("http://www.asp.net/");
// 重定向到当前应用程序中的另一个URL
return LocalRedirect("/account/login");
// 重定向到指定的Action
return RedirectToAction("login");
// 重定向到指定的路由
return RedirectToRoute("default", new { action = "login", controller = "Login" });
内容
包括 ViewResult、PartialViewResult、JsonResult 和 ContentResult 等,其中 ViewResult
和 PartialViewResult
在 MVC 视图应用中非常常见,用于返回相应的页面;JsonResult
用于返回JSON 字符串,ContentResult
用于返回一个字符串。