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：

Views\{ControllerName}\{ActionName}.cshtml
寻找与Controller同名的子目录，再找到与Action同名的*.cshtml。
如上例HomeController.Index()，就会找项目目录下的Views\Home\Index.cshtml文件。
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

巴特西