ASP.NET Core 2 學習筆記（六）MVC

 ASP.NET Core MVC跟ASP.NET MVC觀念是一致的，使用上也沒有什麼太大的變化。以前的ASP.NET MVC把MVC及Web API的套件分開，但在ASP.NET Core中MVC及Web API用的套件是相同的。

本篇將介紹ASP.NET Core MVC設置方式。

MVC 簡介

ASP.NET Core的MVC(Model-View-Controller)架構模式延續ASP.NET MVC，把網站分紅三大元件Model、View及Controller，依賴關係以下圖：

• Model
  負責數據處理，包含數據存取、業務邏輯、定義數據對象及驗證數據。
• View
  負責UI顯示，如HTML、CSS等界面設計配置。
• Controller
  負責將使用者Requset找到相對應的Model及View，作爲控制流程的角色。

在ASP.NET Core中使用MVC或Web API，須要Microsoft.AspNetCore.Mvc套件。

註冊MVC 服務

在Startup.cs的ConfigureServices加入MVC的服務，並在Configure對IApplicationBuilder使用UseMvcWithDefaultRoute方法註冊MVC預設路由的Middleware。以下：

Startup.cs

// ...
public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddMvc();
    }

    public void Configure(IApplicationBuilder app)
    {
        app.UseMvcWithDefaultRoute();
    }
}

• UseMvcWithDefaultRoute

這個是ASP.NET Core的預設路由，會將Request來的URL找到對應的Controller及Action。

 

MVC 示例

Model

創建一個簡單的Model 用於Controller 跟View 互動。

Models\UserModel.cs

namespace MyWebsite.Models
{
    public class UserModel
    {
        // 名稱
        public string Name { get; set; } = "SnailDev";
    }
}

 

Controller

在項目目錄下創建一個Controllers文件夾，把Controller都放這個目錄。
過去ASP.NET把MVC及Web API用的Controller分爲Controller及ApiController，如今ASP.NET Core把二者合一，再也不區分ApiController。
因此要創建一個類，名稱後綴Controller便可，以下：

Controllers\HomeController.cs

namespace MyWebsite.Controllers
{
    public class HomeController
    {
        public string Index()
        {
            return "this is homecontroller index action";
        }
    }
}

但要讓Controller跟View互動，仍是須要繼承Controller比較方便，以下：

Controllers\HomeController.cs

using Microsoft.AspNetCore.Mvc;
using MyWebsite.Models;

namespace MyWebsite.Controllers
{
    public class HomeController : Controller
    {
        public IActionResult Index()
        {
            var user = new UserModel();
            return View(model: user);
        }
    }
}

IActionResult回傳的方式能夠有不少種，經過繼承Controller後，就可使用Controller的方法：

• View
  以上例來講，經過回傳View方法，能夠找到該Controller & Action對應的*.cshtml，而且把UserModel傳給View使用。
• HTTP Status Code
  響應包含HTTP Status。經常使用的響應有Ok、BadRequest、NotFound等。
  例如：return BadRequest("Internal Server Error")，會響應HTTP Status 400及Internal Server Error字串。
• Redirect
  能夠把Request轉給其餘的Action或URL。轉向的方法有Redirect、LocalRedirect、RedirectToAction、RedirectToRoute等。
  例如：return RedirectToAction("Login", "Authentication")，就會把Request轉向到AuthenticationController的Login()。
• Formatted Response
  響應時指定Content-Type。Web API的回傳一般都用這種方式，序列化對象順便標註Content-Type。
  例如：return Json(user)，會將對象序列化成JSON字串，並在HTTP Headers帶上Content-Type=application/json。

 

View

View跟Controller有相互的對應關係，預設在Controller使用View方法回傳結果，會從如下目錄尋找對應的*.cshtml：

1. Views\{ControllerName}\{ActionName}.cshtml
   尋找與Controller同名的子目錄，再找到與Action同名的*.cshtml。
   如上例HomeController.Index()，就會找項目目錄下的Views\Home\Index.cshtml文件。
2. Views\Shared\{ActionName}.cshtml
   若是Controller同名的子目錄，找不到Action同名的*.cshtml。就會到Shared目錄找。如上例HomeController.Index()，就會找項目目錄下的Views\Shared\Index.cshtml文件。

Views\Home\Index.cshtml

@model MyWebsite.Models.UserModel

Hello~ 我是 @Model.Name

在*.cshtml用@model綁定Model的型別，纔可使用@Model取得Controller傳入的對象。

示例結果

 

數據流動圖以下：

參考

Overview of ASP.NET Core MVC 
ASP.NET Core - Setup MVC

 

老司機發車啦：https://github.com/SnailDev/SnailDev.NETCore2Learning