新增控制器

作者：Rick Anderson

注意

本教學課程的更新版本可在此取得，它使用最新版的 Visual Studio。 新的教學課程會使用 ASP.NET Core MVC，它在本教學課程提供多種改良。

本教學課程可讓您了解 ASP.NET Core MVC 與控制器和檢視。 Razor 頁面是 ASP.NET Core 中的新替代方案，它是以頁面為基礎的程式設計模型，可讓 Web UI 的建立更容易且更有效率。 建議您在嘗試使用 MVC 版本之前，先試試 Razor 頁面教學課程。 Razor 頁面教學課程：

• 比較容易學習。
• 涵蓋更多功能。
• 是開發新應用程式的建議方法。

MVC 代表 model-view-controller。 MVC 是一種開發應用程式的模式，架構良好、可測試且容易維護。 MVC 型應用程式包含：

• Models：代表應用程式資料，並且使用驗證邏輯來對該資料執行商務規則的類別。
• Views：應用程式用來動態產生 HTML 回應的範本檔案。
• Controllers：處理傳入瀏覽器要求、擷取模型資料，然後指定檢視範本來對瀏覽器傳回回應的類別。

我們會在本教學課程系列說明這些概念，並且示範如何使用它們來建置應用程式。

我們先從建立控制器類別開始。 在 [方案總管] 以滑鼠右鍵按一下 [Controllers] 資料夾，然後按一下 [新增]，再按一下 [控制器]。

在「新增架構」對話方塊按一下 [MVC 5 控制器 - 空白]，然後按一下 [新增]。

將新的控制器命名為「HelloWorldController」，然後按一下 [新增]。

請注意，方案總管已建立名為 HelloWorldController.cs 的新檔案，以及新的資料夾 Views\HelloWorld。 控制器會在 IDE 開啟。

以下列程式碼取代檔案的內容。

using System.Web;
using System.Web.Mvc; 
 
namespace MvcMovie.Controllers 
{ 
    public class HelloWorldController : Controller 
    { 
        // 
        // GET: /HelloWorld/ 
 
        public string Index() 
        { 
            return "This is my <b>default</b> action..."; 
        } 
 
        // 
        // GET: /HelloWorld/Welcome/ 
 
        public string Welcome() 
        { 
            return "This is the Welcome action method..."; 
        } 
    } 
}

控制器方法會傳回 HTML 字串來當作範例。 控制器名為 HelloWorldController，而第一個方法則名為 Index。 接著我們從瀏覽器叫用它。 執行應用程式 (按 F5 或 Ctrl+F5)。 在瀏覽器中，將「HelloWorld」附加到位址列的路徑。 (例如在下圖中，它是 http://localhost:1234/HelloWorld.) 瀏覽器的頁面看起來會類似下列螢幕擷取畫面。 在上述方法中，程式碼會直接傳回字串。 您命令系統只傳回 HTML，而它也如期運作！

ASP.NET MVC 會根據傳入 URL 叫用不同的控制器類別 (和類別中的不同動作方法)。 ASP.NET MVC 使用的預設 URL 路由邏輯會使用如下格式來判斷要叫用的程式碼：

/[Controller]/[ActionName]/[Parameters]

您可以在 App_Start/RouteConfig.cs 檔案設定路由的格式。

public static void RegisterRoutes(RouteCollection routes)
{
    routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

    routes.MapRoute(
        name: "Default",
        url: "{controller}/{action}/{id}",
        defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
    );
}

如果您執行應用程式但不提供任何 URL 區段，它預設會使用「Home」控制器和上述程式碼預設區段所指定的「Index」方法。

URL 的第一個部分會判斷要執行的控制器類別。 因此，/HelloWorld 會對應 HelloWorldController 類別。 URL 的第二部分則決定了類別要執行的動作方法。 因此 ，/HelloWorld/Index 會使 HelloWorldController 類別的 Index 方法執行。 請注意，我們只需要前往 /HelloWorld，系統預設就會使用 Index 方法。 這是因為如果未明確指定方法，名為 Index 的方法就會是針對控制器呼叫的預設方法。 URL 區段的第三個部分 (Parameters) 是路由資料。 我們稍後會在本教學課程中檢視路由資料。

瀏覽至 http://localhost:xxxx/HelloWorld/Welcome。 Welcome 方法隨即執行，並傳回字串 "This is the Welcome action method..."。 預設的 MVC 對應是 /[Controller]/[ActionName]/[Parameters]。 在此 URL 中，控制器是 HelloWorld，而 Welcome 是動作方法。 您尚未使用 URL 的 [Parameters] 部分。

我們稍微修改範例，以便您將參數資訊從 URL 傳遞至控制器 (例如 /HelloWorld/Welcome?name=Scott&numtimes=4)。 變更 Welcome 方法以包含兩個參數，如下所示。 請注意，程式碼使用 C# 選擇性參數功能來指出若未針對 numTimes 參數傳遞任何值時，該參數預設為 1。

public string Welcome(string name, int numTimes = 1) {
     return HttpUtility.HtmlEncode("Hello " + name + ", NumTimes is: " + numTimes);
}

注意

安全性備註：上述程式碼會使用 HttpUtility.HtmlEncode 來保護應用程式免於惡意輸入 (即 JavaScript)。 如需詳細資訊，請參閱操作方法：將 HTML 編碼套用至字串，藉此防止 Web 應用程式發生指令碼攻擊。

執行應用程式並前往範例 URL (http://localhost:xxxx/HelloWorld/Welcome?name=Scott&numtimes=4)。 您可以在 URL 中針對 name 和 numtimes 嘗試不同的值。 ASP.NET MVC 模型繫結系統會自動將網址列的查詢字串中具名的參數對應至方法中的參數。

上方的範例不會使用 URL 區段 (Parameters) ，name 和 numTimes 參數則會以查詢字串形式來傳遞。 ? 上述 URL 中的 (?) 是分隔符號，隨後接著查詢字串。 & 字元可分隔查詢字串。

以下列程式碼取代 Welcome 方法：

public string Welcome(string name, int ID = 1)
{
    return HttpUtility.HtmlEncode("Hello " + name + ", ID: " + ID);
}

執行應用程式並輸入以下 URL：http://localhost:xxx/HelloWorld/Welcome/1?name=Scott

這次第三個 URL 區段符合路由參數 ID.。Welcome 動作方法包含的參數 (ID) 與 RegisterRoutes 方法指定的 URL 相符。

public static void RegisterRoutes(RouteCollection routes)
{
    routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

    routes.MapRoute(
        name: "Default",
        url: "{controller}/{action}/{id}",
        defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
    );
}

在 ASP.NET MVC 應用程式中，以路由資料的形式傳入參數 (例如上述操作 ID 的方式) 比以查詢字串的形式傳遞參數更常見。 您也可以新增路由，在 URL 中以路由資料的形式傳入 name 和 numtimes 參數。 在 App_Start\RouteConfig.cs 檔案新增「Hello」路由：

public class RouteConfig
{
   public static void RegisterRoutes(RouteCollection routes)
   {
      routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

      routes.MapRoute(
          name: "Default",
          url: "{controller}/{action}/{id}",
          defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
      );

      routes.MapRoute(
           name: "Hello",
           url: "{controller}/{action}/{name}/{id}"
       );
   }
}

執行應用程式並前往 /localhost:XXX/HelloWorld/Welcome/Scott/3。

對許多 MVC 應用程式而言，預設路由即可運作正常。 您會在本教學課程稍後瞭解如何使用模型繫結器來傳遞資料，且不需要修改預設路由。

在這些範例中，控制器已執行 MVC 的「VC」部分，也就是檢視和控制器工作。 控制器會直接傳回 HTML。 一般來說，您不會希望控制器直接傳回 HTML，因為撰寫程式碼會變得很麻煩。 相反地，我們通會常使用個別的檢視範本檔案來產生 HTML 回應。 我們來看看如何執行這項操作。

上一個下一個