Asp.Net MVC(控制器、控制器動作和動作結果) – Part.3

來自  張子陽：http://www.cnblogs.com/JimmyZhang/archive/2009/01/03/1367644.html

這篇教程探索了ASP.NET MVC控制器（controller）、控制器動作（controller action）和動作結果（action results）這幾個主題。在讀完本篇教程之後，你將會理解控制器如何控制訪問者與ASP.NET MVC網站進行互動的方式。

1.理解控制器

MVC控制器負責響應對ASP.NET MVC網站發起的請求。每一個瀏覽器請求都映射到了一個專門的控制器。舉個例子，設想一下你在瀏覽器地址欄輸入了下面的URL：

http://localhost/product/index/3

在這種情況下，將會調用一個名為ProductController的控制器。ProductController負責產生對瀏覽器請求的響應。舉個例子，控制器可能會返回一個特定的視圖，或者是將使用者重新導向到另一個控制器。

你可以通過在ASP.NET MVC應用程式的Controllers檔案夾下添加一個新的控制器來建立一個新控制器。右鍵點擊控制器的檔案夾，並且選擇功能表項目“Add（添加）”，“New（建立項）”，並選擇“MVC Controller Class（MVC控制器類）”（見圖1）。控制器的名字必須含有Controller尾碼。舉個例子，控制器名稱ProductController沒什麼問題，但是控制器Product就不起作用。

圖1 – 建立一個新的控制器

如果你建立一個新的名為ProductController的控制器，那麼你將會獲得代碼清單1所示的檔案。

代碼清單1 – ProductController.cs

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web;

using System.Web.Mvc;
namespace MvcApp.Controllers {

     public class ProductController : Controller

     {  

         public ActionResult Index()

          {

               // Add action logic here

               throw new NotImplementedException();

          }

     }

}

如同你在代碼清單1中所看到的，控制器不過是一個類（Visual Basic.Net 或者是C#類）。一個控制器是一個繼承自System.Web.Mvc.Controller基類的類。因為控制器繼承自這個基類，所以控制器輕鬆地繼承了一些有用的方法（我們不久將會討論這些方法）。

2. 理解控制器動作

控制器暴露出控制器動作。動作是控制器的一個方法，當你在瀏覽器地址欄輸入某一特定的URL時，將會調用這個方法。舉個例子，假設你對下面這個URL發出請求：

http://localhost/Product/Index/3

在本例中，Index()方法在ProductController類上被調用。Index()方法是控制器動作的一個例子。

一個控制器動作必須是控制器類的一個公用方法。C#方法，預設時，是私人方法。意識到你添加到控制器類中的任何公用方法都會自動被暴露為控制器動作（你必須非常小心，因為控制器動作可以被全球的任何人調用，僅僅簡單地通過在瀏覽器地址欄輸入正確的URL）。

控制器動作還要滿足一些額外的需求。作為控制器動作來使用的方法不能夠重載。另外，控制器動作不能為靜態方法。除了這些以外，你可以將任何方法作為控制器動作來使用。

3. 理解控制器結果

控制器動作返回一種叫做動作結果（Action Result）的東西。動作結果是控制器動作返回給瀏覽器請求的東西。

ASP.NET MVC架構支援六種標準類型的動作結果：

1. ViewResult – 代表HTML及標記。
2. EmptyResult – 代表無結果。
3. RedirectResult – 代表重新導向到一個新的URL。
4. RedirectToRouteResult – 代表重新導向到一個新的控制器動作。
5. JsonResult – 代表一個JSON（Javascript Object Notation）結果，它可以用於AJAX應用程式。
6. ContentResult – 代表著文本結果。

所有這些動作結果都繼承自ActionResult基類。

在大多數情況下，控制器動作 ViewResult。例如，代碼清單2中的Index()控制器動作返回了一個ViewResult。

代碼清單2 – BookController.cs

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web;

using System.Web.Mvc;
namespace MvcApp.Controllers {

     public class BookController : Controller

     {

          public ActionResult Index()

          {  

              return View();

          }

     }

}

當一個動作返回一個ViewResult，將會向瀏覽器返回HTML。代碼清單2中的Index()方法向瀏覽器返回了一個名為Index.aspx的視圖。

注意到代碼清單2中的Index()動作並沒有放回一個ViewResult()。而是調用了Controller基類的View()方法。通常情況下，你並不直接返回一個動作結果。而是調用Controller基類的下列方法之一：

1. View – 返回一個ViewResult結果。
2. Redirect – 返回一個RedirectResult 動作結果。
3. RedirectToAction – 返回一個RedirectToAction動作結果。
4. RedirectToRoute – 返回一個RedirectToRoute動作結果。
5. Json – 返回一個JsonResult動作結果。
6. Content – 返回一個ContentResult動作結果。

因此，如果你想向瀏覽器返回一個視圖，你可以調用View()方法。如果你想要降使用者從一個控制器動作重新導向到另一個，你可以調用RedirectToAction()方法。舉個例子，代碼清單3中的Details()動作要麼顯示一個視圖，要麼將使用者重新導向到Index()動作，取決於Id參數是否含有值。

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web;

using System.Web.Mvc;
namespace MvcApp.Controllers {

     public class CustomerController : Controller

     {

          public ActionResult Details(int? Id)

          {  

              if (Id == null)  

                   return RedirectToAction("Index");

               return View();

          }
          public ActionResult Index()

          {  

              return View();

          }

     }

}

ContentResult動作結果很特別。你可以使用ContentResult動作結果來將動作結果作為純文字返回。舉個例子，代碼清單4中的Index()方法將訊息作為了純文字返回，而不是HTML。

代碼清單4 – StatusController.cs

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web;

using System.Web.Mvc;
namespace MvcApp.Controllers {

     public class StatusController : Controller

     {

          public ContentResult Index()

          {

               return Content("Hello World!");

          }

     }

}

當調用StatusController.Index()動作時，並沒有返回一個視圖。而是向瀏覽器返回了原始的文本“Hello World！”。

如果一個控制器動作返回了一個結果，而這個結果並非一個動作結果 – 例如，一個日期或者整數 – 那麼結果將自動被封裝在ContentResult中。舉個例子，當調用代碼清單5中的WorkController的Index()動作時，日期將自動作為一個ContentResult返回。

代碼清單5 – WorkerController.cs

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web;

using System.Web.Mvc;
namespace MvcApp.Controllers {

     public class WorkController : Controller

     {

          public DateTime Index()

          {

               return DateTime.Now;

          }

     }

}

代碼清單5中的Index()動作返回了一個DateTime對象。ASP.NET MVC架構自動將DateTime對象轉換為一個字串，並且將DateTime值封裝在一個ContentResult中。瀏覽器將會以純文字的方式收到日期和時間。

4. 總結

這篇教程的目的是為你介紹ASP.NET MVC中控制器、控制器動作以及控制器動作結果的概念。在第一部分，你學習了如何向ASP.NET MVC項目中添加新的控制器。接下來，你學習了控制器的公用方法是如何作為控制器動作暴露給全世界的。最後，我們討論了動作結果的各種不同類型，這些動作結果可以從控制器動作中返回。特別地，我們討論了如何從控制器動作中返回一個ViewResult、RedirectToActionResult和ContentResult。