MVC-03 控制器（2）

五、ActionResult解说

ActionResult的继承图：

类型	Controller辅助方法	用途帮助
ContentResult	Content	回传一个用户自定义的文字属性
EmptyResult		不响应任何信息到客户端
FileReslt FileContentResult FilePathResult FileStreamResult	File	以二进制串流的方式回传一个文档信息： 直接输出byte[]属性 指定文档路径输出文档属性 指定Stream对象回传其属性
HttpStatusCodeResult HttpNotFoundResult HttpUnauthorizedResult	HttpNotFound	回传自定义的HTTP状态代码与消息： 回传HTTP404状态代码 回传HTTP401状态代码
JavaScriptResult	JavaScript	回传的是JavaScript脚本
JsonResult	Json	将数据串行化成JSON格式回传
RedirectResult	Redirect RedirectPermanent	重新导向指定的URL
RedirectToRouteResult	RedirectToAction RedirectToActionPermanent RedirectToRoute RedirectToRoutePermanent	与RedirectResult类似，但是它重导向到一个Action或Route
ViewResultBase ViewResult PartialViewResut	View PartialView	回传一个View页面 回传检视页面（View Page） 回传部分检视页面（Partial View）

public ActionResult Index()
{
    return new RedirectToRouteResul ( new RouteValueDictionary (
        new{ action="About'}));
}

public ActionResult Index()
{
    return RedirectToAction( "About");
}

1.ViewResult

ViewResult是在ASP.NET MVC中最常用的ActionResult，用于回传一个标准的视图页面。通过Controller辅助方法能更方便地定义要如何输出视图页面，可以指定要输出的View名称、指定该View要套用哪几个母版页面（Layout Page）、指定要传入View的数据模型（Model）。

（1）回传默认的视图页面

public class HomeController:Controller

{

public ActionResult bout()

{

return View();

}

}

（2）指定视图页面名称响应

如下演示会运行/Views/Home/About2.cshtml视图页面，并将结果输出至客户端。

public class HomeController:Controller

{

public ActionResult bout()

{

return View("About2");  //About2是视图的名字

}

}

（3）指定的视图页面不存在

public class HomeController:Controller

{

public ActionResult bout()

{

return View("AAA");

}

}

该视图找不到，出现异常。在搜索目录时，ASP.NET MVC会到网站根目录下Views目录里先搜索第一层目录，默认将会先搜索与Controller同名的目录。如果找不到相对应的View页面，就会改为搜索Shared目录，在views目录下的Shared目录中通常会放置共享于多个Controller之间的View页面，例如默认项目模板内就放置了模板页面（_Layout.cshtml）、共享的部分页面（_LoginPartial.cshtml）与错误显示页面（Error.cshtml）。

（4）指定视图和母版名称

public ActionResult Index()
{
    return View("Index", "_Layout2");
}

（5）传入model强类型对象

public ActionResult Read ( int id )
{
     Models.MvcGuestbookContext db=new MvcGuestbookContext();
     var model=from p in db.Messages where p.Id==id select p;
     return View(model);
} 

2.PartialViewResult

PartialViewResult与ViewResult非常类似，但无法为选中的View指定母版页面。如果想在页面中设计出更好的关注点分离特性，可以将网页的其中一部分独立成另一个动作，这时就可以利用PartialViewResult取得页面中的部分属性。

public ActionResult Index_Marquee()
{
      return PartialView();
}

可参考例子默认Internet项目里面的layout母版中，登录部分视图等。

3.EmptyResult

有些action不需要回传任何数据，例如，我们想在网站实现联机人数的统计功能，可以从网页中动态发出一个HTTP请求给Controller的其中一个Action，当Controller收到要求后会在Action里运行加总或记录的动作，之后不回传任何数据，因为这个action的主要目的就是统计数据而已。

遇到这种情况，使用EmptyResult就非常合适，其使用方法如下：

public ActionResult OnlineUserHit()

{

return new EmptyResult();

}

或如下：

public ActionResult OnlineUserHit()

{

return；

}

4.ContentResult

ContentResult可以让你响应任意”文字属性“的结果，可以任意指定文字属性、属性类型（Content-Type）与文字编码（Encoding）。

（1）响应XML文字

public class Default1Controller : Controller
    {
        public ActionResult GetXML()
        {
            return Content("<ROOT><TEXT>123</TEXT></ROOT>", "text/xml", System.Text.Encoding.UTF8);
        }
    }

（2）响应UTF-8编码的HTML字符串

public ActionResult GetXML()
        {
            string strHTML = "...";  //省略HTML的属性
            return Content(strHTML);
        }

（3）直接回传字符串类型

public string Content()

{

string strHTML="....";  //省略HTML的属性

return strHTML;

}

5.FileResult

FileResult可以响应任意文档的属性，包括二进制格式的数据，例如，图片、PDF、Excel文件或ZIP压缩文件等，可以传入byte[]、文档路径、Stream等不同的属性方式，让ASP.NET MVC帮你将属性回传给客户端。除此之外，还能指定回传时的属性类型（Content-Type）或指定客户端下载时要显示的文件名等。

事实上，FileResult是一个抽象类型，有三种类型分别如下：

• FilePathResult：响应一个实体文档的属性
• FileContentResult：回应一个byte[]属性
• FileStreamResult：回应一个Stream属性

通过System.Web.Mvc.Controller类型中所提供的File辅助方法，可以不用记忆这么多，一个File辅助方法就能自动选定不同的FileResult响应。

（1）通过Action输出一个放在App_Data目录下的PNG图片文件。第一个参数指定文件路径，第二个参数指定文件的 MIME 类型。

        public ActionResult GetFile()
        {
            return File(Server.MapPath("~/App_Data/UserA/avatar.png"), "image/png");
        }

（2）将zip文件发送至浏览器。

public ActionResult FilePathDownload1()
{
    var path = Server.MapPath("~/Files/鹤冲天.zip");
    return File(path, "application/x-zip-compressed");
}

用户点击浏览器上的下载链接后，会调出下载窗口：

大家应该注意到，文件名称会变成 Download1.zip，默认成了 Action 的名字。我们使用 File 方法的第二个重载来解决文件名的问题：

public ActionResult FilePathDownload2()
{
    var path = Server.MapPath("~/Files/鹤冲天.zip");
    return File("g:\\鹤冲天.zip", "application/x-zip-compressed", "crane.zip");
}

public ActionResult FilePathDownload3()
{
    var path = Server.MapPath("~/Files/鹤冲天.zip");
    var name = Path.GetFileName(path);
    return File(path, "application/x-zip-compressed", name);
}

我们可以通过给 fileDownloadName 参数传值来指定文件名，fileDownloadName 不必和磁盘上的文件名一样。下载提示窗口分别如下：

6.JavaScriptResult

JavaScriptResult的用途是响应JavaScript程序代码给浏览器，通过Ajax的程序开发，你可以利用JavaScriptResult来响应适当的JavaScript程序代码让浏览器动态运行。

其实JavaScriptResult的功能与ContentResult差不多，主要的差别在与默认的Content-Type不一样而已，JavaScriptResult默认的Content-Type为application/x-javascript。

如下演示即响应alert('ok')至客户端。

public ActionResult JavaScript()
{
    return JavaScript("alert('ok')");
}

如果在View中，利用Ajax辅助方法撰写以下程序，就会动态调用JavaScript这个Action，并直接在浏览器中运行结果，过程中并不会换页：

@Ajax.ActionLink("Run JavaScript", "JavaScript", new AjaxOptions())

7.JsonResult

JSON（JavaScript Object Notation）是Web在实现Ajax应用程序时进场使用的一种传输数据格式，JsonResult可自动将任意对象数据串行化成JSON格式回传，JsonResult默认的ContentType为application/json。对某些JavaScript Framework这是必要需求，例如，jQuery。

JsonResult是使用JavaScriptSerializer完成JSON串行化操作，但如果你的对象无法串行化，这个转换的过程将会发生异常。

在使用JsonResult时必须特别注意，从ASP.NET MVC 2.0开始，为了避免JSON Hijacking的攻击，ASP.NET MVC开发团队基于安全性考虑，在默认的情况下，任何以JsonResult回传的要求都不允许HTTP GET取得任何JSON信息。

下面代码演示了在MVC的Ajax.ActionLink中如何使用JsonResult

Action

[HttpPost]
public ActionResult GetDetail()
{
    return Json(new
    {
        UserName = "Test User Name",
        Email = "Test@Test.com",
        Desc = "Test Desc"
    });
}

View

<script type="text/javascript">
    function handleSuccess(context) {
        $("#userName").html(context.UserName);
        $("#email").html(context.Email);
        $("#desc").html(context.Desc);
    }
</script>
<table>
    <tr>
        <td>
            UserName
        </td>
        <td>
            <div id="userName" />
        </td>
    </tr>
    <tr>
        <td>
            Email
        </td>
        <td>
            <div id="email" />
        </td>
    </tr>
    <tr>
        <td>
            Desc
        </td>
        <td>
            <div id="desc" />
        </td>
    </tr>
</table>
@Ajax.ActionLink("Click Me", "GetDetail", new AjaxOptions { HttpMethod = "POST", OnSuccess = "handleSuccess" })

在点击ActionLink后，会调用GetDetailAction返回JsonResult，在OnSuccess方法中可以对返回的结果进行处理。

8.RedirectResult

ResirectResult的主要用途是运行重新导向到其他网址。以下演示就是使用RedirectResult将结果转至/Home/Index页面。

        public ActionResult Redirect()
        {
            return Redirect("/Home/Index");
        }

试试看跳转到百度等外网地址。

9.RedirectToRoute

RedirectToRoute会替你运算所有现有的网址路由值（RouteValue），并比对网址路由表（RouteTable）中的每条规则。Controller类型中有四个与RedirectToRoute有关的辅助方法。

（1）RedirectToAction，让浏览器转向至该Action的网址

        public ActionResult RedirectToActionSample()
        {
            return RedirectToAction("SamplePage");
        }

        public ActionResult RedirectToActionSample()
        {
            return RedirectToAction("List", "Member");
        }

        public ActionResult RedirectToActionSample()
        {
            return RedirectToAction("List","Member",new{page=})
        }

（2）RedirectToActionPermanent

（3）RedirectToRoute

（4）RedirectToRoutePermanent

10.HttpStatusCodeResult

HttpStatusCodeResult的主要用途是让ASP.NET MVC回传特定的HTTP状态代码与消息给客户端。对于一些特殊的HTTP响应，可利用HttpStatusCodeResult帮助我们响应适当的状态代码。

        public ActionResult Create(FormCollection form)
        {
            //TODO:依据客户端窗体输入的数据在数据库中创建一条新记录
            return new HttpStatusCodeResult(System.Net.HttpStatusCode.Created, "数据已被成功创建");
        }

11.HttpNotFoundResult

HttpNotFoundResult专门用来响应HTTP404找不到网页的错误，在System.Web.Mvc.Controller类型中内建了一个HttpNotFound辅助方法，可以方便回传HttpNotFoundResult类型的ActionResult结果，程序演示如下。

        public ActionResult Get(int id)
        {
            var data = GetDataFromDB(id);

            if (data = null)
            {
                return HttpNotFound();
            }
            else
            {
                return View(data);
            }
        }

12.HttpUnauthorizedResult

HttpUnauthorizedResult专门用来响应HTTP 401拒绝访问的错误，例如，你可以在Action里做出一些额外的权限检查，如果查出客户端用户并没有特定数据的访问权限，即可利用HttpUnauthorizedResult响应“拒绝访问”的HTTP状态代码，程序演示如下。

public ActionResult Get(int id)
{
   if(CheckPermission(User.Identity.Name)
   {
       var data=GetDataFromDB(id);
       if(data==null)
       {
           return HttpNotFound();
        }
       else
       {
           return View(data);
        }
    }
    else
    {
        return new HttpUnauthorizedResult();
    }
}