.NET MVC之ActionResult

ActionResult是所有Controler返回值的父类。各种结果都是由ActionResult包装后发往客户端的。

继承结构

System.Object

System.Web.Mvc.ActionResult

从基层结构上来划分，基本上可以分为四类。视图类、文本类、文件类和状态码类。

视图类返回结果

先从我们最熟悉的视图类来说起。View()与PartialView()它们分别返回ViewResult和PartialViewResult。从我们第一次接触到.NET MVC开始就在用。作用就是将处理好的数据交给视图引擎（如果有的话），来渲染视图。

返回值	帮助方法	描述
ViewResult	View	渲染一个网页视图
PartialViewResult	PartialView	渲染一个网页视图，但不使用布局页

一般我们为每个action创建的视图都是部分视图，里面只包含了一个网页中的一部分。View()在渲染完视图后会将结果嵌入在布局页中，返回网页的全部，而PartialView()在渲染完之后就直接将结果发送给了客户端。

文本类返回结果

返回值	帮助方法	描述
ContentResult	Content	返回一段字符串文本，文本的内容格式用户可通过MIME指定
JsonResult	Json	将数据序列化成JSON，之后返回给客户端
JavaScriptResult	JavaScript	返回一段JavaScript格式的字符串

Content()

使用Content()方法和直接返回一个string字符串没什么区别，只不过你可以通过Content()指定一下返回内容的格式（XML或HTML等）与字符编码。


public string Content()
{
    return "<h1>HelloKitty</h1>";   //浏览器显示  HelloKitty
}

public ActionResult Content2()
{
    //return Content("<h1>GoodbyeKitty</h1>"); //浏览器显示  GoodbyeKitty
    //指定返回文本的格式与字符编码
    return Content("<h1>GoodbyeKitty</h1>", "text/html",System.Text.Encoding.UTF8);
}

//效果都是一样的

Json()

传入一个任意类型的对象，尽可能地将它格式化为JSON格式。我试过基本上任何类型的对象都可以进行格式化，只不过对于文件或图片这类东西格式化之后只是一大堆没用的乱码。

普遍来说，Dictionary这种键值对类型会被转换成js类，List这类会被转换成js数组。


class Student
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public ActionResult JSON1()
{
    var array = new List<Student>();
    array.Add(new Student { Name = "小明", Age = 12 });
    array.Add(new Student { Name = "小李", Age = 15 });
    return Json(array,JsonRequestBehavior.AllowGet);    //JsonRequestBehavior用于指定是否允许GET方式访问，默认只允许POST

    //运行结果：[{"Name":"小明","Age":12},{"Name":"小李","Age":15}]
}

public ActionResult JSON2()
{
    //也可使用匿名内部类来保存数据
    return Json(new { name = "test", age = 16, sex = "boy" }, JsonRequestBehavior.AllowGet);

    //运行结果：{"name":"test","age":16,"sex":"boy"}
}

JavaScript()

JavaScript()直接返回一个JavaScript代码字符串。JavaScript()的效果实际上和Content()是一样的，只不过JavaScript()会自动指定返回文本的内容是application/x-javascript。


public ActionResult JS()
{
    return JavaScript("alert(‘" + DateTime.Now.ToLongTimeString() + "‘)");
}

public ActionResult JS2()
{
    return Content("alert(‘" + DateTime.Now.ToLongTimeString() + "‘)", "application/x-javascript");
    //这样写效果和上面完全是一样的
}

/*
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <script src="http://localhost:5695/home/js2"></script>
        <!--可以直接在script标签中填写action的地址-->
    </head>
    <body></body>
    </html>
*/

文件类返回结果

Controler中可以用于返回文件的方法也就只有File()。File()可以通过多种形式来发送文件，可以通过文件名、二进制Byte[]、Stream流。发送时还需要通过MIME标明一下文件类型。


public ActionResult FILE1()
{
    System.IO.Stream fs = System.IO.File.OpenRead(@"test.png");
    return File(fs, @"image/png");  //通过流的方法
}

public ActionResult FILE2()
{
    return File(@"test.png", @"image/png"); //通过文件名的方式
}

public ActionResult FILE3()
{
    System.Drawing.Bitmap b = new System.Drawing.Bitmap(100, 100);  //创建一张空白图片
    System.IO.MemoryStream ms = new System.IO.MemoryStream();
    b.Save(ms, System.Drawing.Imaging.ImageFormat.Bmp);
    byte[] bytes = ms.GetBuffer();

    return File(bytes, @"image/bmp");   //通过二进制数据的方式
}

/*
    //现在可以直接将地址赋值给img标签来进行显示了
    <img src="http://localhost:5695/home/file1" >
*/

注意：返回的文件不要太大，否则会造成内存溢出。如果要下载大文件，最好就直接返回文件地址。

实现防盗链

如果只是简单的返回一个文件就太没有意思了。通过控制器来返回文件相对于直接将文件地址给用户而言，我们可以进行一些处理操作，比如只允许登陆过的用户查看此图片，或者在图片上添加水印。


public ActionResult FILE1()
{
    if (HttpContext.User.Identity.IsAuthenticated)
        //如果用户登录了才显示图片
        return File(@"test.png", @"image/png");
    else
        //没有登录就显示一张防盗链图片
        return File(@"test.png", @"image/png");
}

实现验证码

通过动态生成一张图片返回给客户端。具体步骤可以参考我这篇博文.NET MVC 验证码。

状态码类返回结果

返回值	帮助方法	描述
RedirectResult	Redirect	返回一个HTTP 302状态码，使客户端浏览器跳转到指定的URL
RedirectToRouteResult	RedirectToAction	返回一个HTTP 302状态码，使客户端浏览器跳转到指定的action
RedirectToRouteResult	RedirectToRoute	跳转到指定的URL，这取决于路由API
HttpStatusCodeResult	(None)	返回一个特定的HTTP 状态码与描述
HttpUnauthorizedResult	(None)	返回一个HTTP 401状态码，提示用户未登录
HttpNotFoundResult	HttpNotFound	返回一个HTTP 404状态码，提示用户访问的资源不存在
EmptyResult	(None)	返回一个HTTP 200状态码表示请求成功，但不包含任何信息

如果action返回结果为null，Controler会自动将null替换为EmptyResult。