ASP.NET MVC5基础-控制器(Controller)详解

时间:2024-03-12 12:10:43

在上文ASP.NET MVC5基础 – MVC文件架构中我们简单了解了下控制器Controller的作用,本文我将详细介绍控制器Controller的使用方法。

Controller的运行过程

上文我们已经讲到,控制器负责响应浏览器传送过来的所有请求。在MVC中,每一个浏览器请求都映射到一个控制器(Controller)中,每个请求都会有个动作(Action),只要动作存在,就可以通过该动作方法接收客户端传来的请求与决定响应的视图(View)。

我们以之前创建的MVC项目为例,打开项目的Index.cshtml页面。

显示的界面如下:

可以看到,页面的地址栏URL为:http://localhost:61515/Home/Index

根据路由规则,Home是控制器(Controller)名,Index是动作(Action)名。所以这个URL调用的是HomeController控制器下的Index方法。

在Index方法中,只有这么一行代码:return View();,表示返回视图,然后返回给浏览器的是Views/Home文件夹下的Index.cshtml页面。

虽然我们在Index方法中没有指定返回哪个页面,但根据ASP.NET MVC的约定规则,控制器会找到Views文件夹中,与Controller名称相同文件夹下的同一方法名的页面。所以返回的是Home下的Index.cshtml页面。具体的有关控制器返回View的内容下文会详细说明。

控制器的运行过程大体如上,从浏览器请求到控制器返回结果的整体流程为:

Controller请求参数处理

试想一下,我们在浏览器地址栏经常能看到URL后面接很多个参数,比如百度搜索:https://www.baidu.com/s?ie=UTF-8&wd=梦中的Aoede 在URL后面接了ie和wd两个参数,那么这种参数在MVC中是怎样获取的呢?

举个例子,我们给首页链接增加两个参数:http://localhost:61515/Home/Index?name=梦中的Aoede&age=18

那么在Index方法中,正常情况我们可以通过Request.QueryString获取到这两个参数。如下:

public ActionResult Index()
{
    var name = Request.QueryString["name"];
    var age = Request.QueryString["age"];
    return Content($"name:{name},age:{age}");
}

打开http://localhost:61515/Home/Index?name=梦中的Aoede&age=18,显示如下:

其实在MVC中,参数的传递是通过模型绑定(Model Binding)机制从RequestContext中获取到参数数据的。获取到数据之后再将数据传入到方法的参数中,所以我们只需要在方法中增加两个参数即可,如下:

public ActionResult Index(string name,int age)
{
    return Content($"name:{name},age:{age}");
}

打开页面输出结果还是一样的:


相同的,如果浏览器通过POST方式传过来一个表单,那么我们也可以在Index参数中使用表单对应的Model实体类来接收。在此我就不赘述了。

Controller返回值说明

Action处理完请求后,会将结果返回给客户端。Action返回的结果我们称为动作结果(Action Result)。

所有的动作结果都继承自ActionResult基类,以HomeController中的Index方法为例,它return的View()就是一个ViewResult类,ViewResult类也是ActionResult的子类。

ASP.NET MVC框架支持六种标准类型的动作结果:

动作名称

概述

方法名

ViewResult

视图内容,HTML或标记

View

EmptyResult

空内容

 

RedirectResult

重定向到新的URL

Redirect

RedirectToRouteResult

重定向到新的控制器

RedirectToAction/RedirectToRoute

JsonResult

返回一个JSON(Javascript Object Notation)内容

Json

ContentResult

返回文本内容

Content

需要注意的是,虽然控制器返回的是动作结果(Action Result),但在代码中,我们调用的是Controller基类中的方法。在上文的表中有对应的方法名。

除了以上六种动作结果以外,你还可以给Action方法返回其他类型的返回值,这个返回值会自动被包装在ContentResult中。比如这段代码:

public class HomeController : Controlle
{
    public DateTime Index()
    {
        return DateTime.Now;
    }
}

Index返回的是DateTime对象,而在浏览器中,显示的是一个日期字符串。

MVC过滤器

过滤器在MVC中也是个非常重要的概念,本文仅简单介绍下什么是过滤器,详细的内容我会在后续文章中深入说明。

过滤器(Filters)就是向请求处理管道中注入额外的逻辑。

过滤器有不同类型,MVC支持的过滤器有:授权(Authorization)、行为(Action)、结果(Result)和异常(四种),不同类型有不同的作用。

我们以授权(Authorization)为例简单说明下。比如我们有个方法,只有登录用户才可以调用,那么我们只需要添加一个验证用户是否登录的授权过滤器,在对应的方法上方添加此过滤器的标记即可。

总结

通过本文可以了解到,Controller的运行过程,Controller中Action如何获取参数、以及Action的返回值类型等内容。

更多内容可访问我的个人博客:http://www.yunc.top/