創建ASP.NET Core MVC應用程序(1)-添加Controller和View

參考文檔：Getting started with ASP.NET Core MVC and Visual Studio

這系列文章是參考了.NET Core文檔和源碼，可能有人要問，直接看官方的英文文檔不就可以了嗎，為什么還要寫這些文章呢？

原因如下：

• 官方文檔涉及的內容相當全面，屬於那種大而全的知識倉庫，不太適合初學者，很容易讓人失去重要，讓人掉入到具體的細節之中。
• 對於大多數人來講開發語言只是工具，程序員都有一個通病，就是死磕工具，把工具學深。我認為在工具上沒有必要投入太多時間，以能高效地完成日常的工作項目為准即可。要需求驅動學習，你需要什么學什么。如果你學的新技術新特性只是屠龍之技或者只需要用到的時候去查一下即可的話，這種死磕這又有什么用。沒有必要花120%的時間去學100%的知識，你只需要花20%的時間去學習80%的知識就可以了，剩下的等實際的項目中用到的時候去查就可以了,工具只是工具，不是工作本身。
• 目前基本所有的文章都是基於Windows平台的Visual Studio IDE來介紹的。而我用的是一台Mac，所以我將基於Mac平台的Visual Studio Code講解適合我們實際項目中遇到的知識。
• 還有一點，就是這是我個人的學習總結。

這系列文章就是讓你去花20%的時間去學80%的東西，剩下的20%再去看官方文檔。

之前介紹了《如何在Mac下運行ASP.NET Core應用程序》，主要是講解了如何在Mac下把ASP.NET Core跑起來，在這一篇中將進一步分析如何添加Controller、View、Model等。

Model-View-Controller (MVC)架構模式將一個應用程序分成了三大塊：Model、View、Controller。

• Models: 用於表示應用程序數據的類，並使用驗證邏輯來約束數據的業務規則。通常模型對象用來從數據庫獲取和存儲實體模型數據。比如User Model 從數據庫獲取用戶數據，並將它交給View來顯示或者直接更新，更新后的數據再寫入到數據庫中。
• Views: 用來顯示應用程序UI的組件，該UI會顯示Model數據。
• Controllers: 是Models和Views的一個橋梁。用來處理瀏覽器請求，獲取Model數據，並將指定視圖模板作為響應返回給瀏覽器。視圖(View)僅僅用於顯示信息，控制器(Controller)用於處理並響應用戶的輸入和交互。比如，Controller處理路由數據查詢字符串值，並將這些值傳遞給Model，Model再去使用這些值去查詢數據庫。

MVC模式幫助你創建一個關注分離的應用程序(輸入邏輯、業務邏輯、UI邏輯),同時這個模塊之間是松耦合的。UI邏輯屬於View，輸入邏輯屬於Controller,業務邏輯屬於Model。

添加Controller

namespace MyFirstApp.Controllers
{
    public class HomeController : Controller
    {
        // GET: /<controller>/
        public IActionResult Index()
        {
            return View();
        }

        // GET: /<controller>/About
        public IActionResult About()
        {
            ViewData["Message"] = "Your application description page.";

            return View();
        }

        public IActionResult Contact()
        {
            ViewData["Message"] = "Your contact page.";

            return View();
        }

        public IActionResult Error()
        {
            return View();
        }

        public IActionResult Welcome(string name, int id = 1)
        {
            ViewData["Message"] = "Hello " + name;
            ViewData["id"] = id;

            return View();
        }
    }
}

在控制器中的每一個public方法都可以作為HTTP終結點被調用。

第一個注釋表示這是一個通過在根URL添加“/Home/”進行調用的HTTP GET方法。第二個注釋表示這是一個通過在根URL添加"/Home/About/"來進行調用的HTTP GET方法。

MVC根據傳入的請求URL調用相應的控制器類以及其中的Action方法，MVC默認使用的URL路由邏輯采用類似於這樣的格式來決定具體的代碼調用：

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

打開Startup.cs你會看到該項目的路由規則：

當你不帶任何URL段(segment)直接運行該程序時，將默認訪問“Home”控制器中的"Index"方法。

第一個URL segment決定運行哪個Controller,所以http://localhost:5000/Home映射到HomeController類；URL segment第二個部分決定類里面的Action方法。所以http://localhost:5000/Home/Index會運行HomeController類中的Index方法；URL segment的第三部分(id)是路由數據。

這里通過增加一個方法來顯示通過URL傳遞一些參數信息到Controller。

public string Welcome(string name, int id = 1)
{
    return HtmlEncoder.Default.Encode($"Hello {name}, id: {id}");
}

上述代碼通過使用HtmlEncoder.Default.Encode來保護應用免受JS的惡意輸入，並且使用了C#的新特性Interpolated Strings。

http://localhost:5000/Home/Welcome?name=Charlire&id=1

MVC的模型綁定系統自動將查詢字符串的命名參數映射到具體的方法中的參數，注意名稱必須一致。

上述代碼中URL segment(Parameters)沒有被使用到，參數name和id都是作為查詢字符串被傳遞的。?是一個分隔符，后面跟着的就是查詢字符串，&用來分割查詢字符串。

輸入下面的URL：http://localhost:5000/Home/Welcome/1?name=Charlire。這一次第三個URL segment將匹配到路由參數id。Welcome方法包含一個與MapRoute方法中的URL模板相匹配的id參數。隨后的?(id?)表示id參數是可選的。

添加View

通過Razor視圖引擎創建視圖模板文件，基於Razor的視圖模板使用 .cshtml 作為文件擴展名，通過使用C#提供了一個優雅的方式來創建HTML。

public IActionResult Index()
{
    return View();
}

上面的Index方法使用視圖模板來生成一個HTML響應給瀏覽器。Controller中的Action方法通常返回一個IActionResult（或一個派生於ActionResult 類），而不是像String這樣的基元類型。

點擊Views文件夾，在該文件夾下面新建與Controller名對應的文件夾。

然后我們導航到Views->User文件夾，運行命令yo aspnet:mvcview Index在該文件夾下面生成Index.cshtml。

Index方法只是簡單地運行了return View()，來指定方法去使用一個視圖模板文件來為瀏覽器渲染最新的響應。因為沒有顯式指定所要使用的視圖模板文件，MVC會默認使用 /Views/User 文件夾中的 Index.cshtml。

改變視圖和布局頁面

通用點擊菜單鏈接，你會發現每一個頁面都顯示了相同的菜單布局，這個菜單布局位於 Views/Shared/_Layout.cshtml 文件。

Layout模板允許你在一個地方指定網站的HTML容器布局，並應用到網站的多個頁面中。@RenderBody()是一個占位符，用來顯示你指定視圖的位置，“包裹在”布局頁面。舉個例子，當你點擊About鏈接，Views/Home/About.cshtml視圖就會在RenderBody方法內渲染。

修改Layout文件中的標題和菜單鏈接

注意現在每一個頁面都顯示了新修改的鏈接，通過在Layout模板中修改一次，網站上的所有的頁面都立即顯示成新修改的信息。

通過查看 Views/_ViewStart.cshtml 文件：

@{
    Layout = "_Layout";
}

Views/_ViewStart.cshtml 文件將 Views/Shared/_Layout.cshtml 文件引入到每一個視圖中。你可以通過Layout屬性來設置一個不同的布局視圖，或將它設置成null，那么將不使用任何一個布局文件。

修改 Views/User/Index.cshtml 文件如下：

@{
    ViewData["Title"] = "User List";
}

<h2>User List</h2>

<p>Hello from View Template!</p>

ViewData["Title"] = "User List";將ViewDataDictionary的Title屬性設置為User List。這個Title屬性將用在 Views/Shared/_Layout.cshtml Layout頁面的<title>HTML元素上。

<title>@ViewData["Title"] - User MVC Application</title>

注意 Index.cshtml 視圖模板中的內容是怎么和 Views/Shared/_Layout.cshtml 視圖模板進行合並的，布局模板使得修改應用里所有的頁面很容易。

從Controller傳遞數據到View

在談到數據庫和模型(Models)之前，先讓我們討論一下從控制器傳遞信息到視圖。控制器方法會在傳入的URL請求響應時被調用。控制器類是用於處理傳入的瀏覽器請求，從數據庫獲取數據，並最終決定哪種類型的的響應會被回傳給瀏覽器。

控制器主要負責提供視圖模板向瀏覽器呈現一個響應所需的數據或對象。

最佳實踐：視圖模板不應該執行業務邏輯或直接與數據庫進行交互，而只應該使用控制器提供給它的數據。保持這樣的“關注分離”有助於保持你的代碼整潔，可測試性及更易於維護。

當前，HomeController控制器中的Welcome方法接受一個name、id參數，然后直接將值輸出到瀏覽器。我們在控制器中將使用一個視圖模板來代替字符串，視圖模板將生成一個動態響應，這就意味着你需要通過控制器傳遞適當的數據給視圖來生成響應，可以讓控制器將視圖模板需要的動態數據（參數）放入ViewData字典中，隨后視圖模板可以通過訪問該字典獲取到這些數據。

ViewData字典是一個動態對象，你可以將任何你想要的數據加進去。在你加入數據之前，ViewData對象沒有任何已定義的屬性。MVC的模型綁定系統自動映射地址欄中查詢字符串的命名參數到你方法中的參數。

public IActionResult Welcome(string name, int id = 1)
{
    ViewData["Message"] = "Hello " + name;
    ViewData["id"] = id;

    return View();
}

ViewData字典對象包括將要傳遞到視圖的數據。接受，我們來創建一個Welcome視圖模板。

這里將在Welcome.cshtml視圖模板中創建一個循環。

@*
    For more information on enabling MVC for empty projects, visit https://go.microsoft.com/fwlink/?LinkID=397860
*@
@{
    ViewData["Title"]= "Welcome Page";
}
<h2>Welcome</h2>

<ul>
    @for(int i=0; i<(int)ViewData["id"]; i++)
    {
        <li>@ViewData["Message"]</li>
    }
</ul>

數據從URL獲得並通過MVC模型綁定器傳遞到控制器，控制器將數據打包封裝到ViewData字典中並將該對象傳遞給視圖。接着，視圖將數據以HTML的形式渲染到瀏覽器。

我們使用了一個ViewData字典來將數據從控制器傳遞到視圖，ViewData字典是一個動態對象,它提供了一種便捷的后期綁定方式來傳遞信息給視圖。接下來我們將使用視圖模型(View Model)來實現相同的目的。通過View Model來傳遞數據比通過ViewData更受歡迎。

個人博客

我的個人博客