0. 前言

在之前我們介紹了請求通過路由尋找到控制器，以及控制器與視圖的數據流轉。那麼，我們回過頭來，再看看路由的一些其他用法。

1. 路由屬性（Route Attribute）

按照英文的直接翻譯，Routing Attribute 的意思是路由屬性，但實際上 Attribute在微軟的官方稱呼是特性。嗯，所以個人覺得Route Attribute應該是特性路由，路由特性。

嗯，暫且甩開稱呼的問題，小伙伴們知道這是一種使用Attribute標記的路由配置方案就行。我們之前瞭解的路由設置都是通過路由表設置的，而Route Attribute則是另外一種方案。

1.1 如何設置

這種方案主要是通過RouteAttribute類來設置的，我們先來看一下這個類是個什麼樣的吧：

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
public class RouteAttribute : Attribute, IRouteTemplateProvider
{
    public RouteAttribute(string template);
    public string Name { get; set; }
    public int Order { get; set; }
    public string Template { get; }
}

AttributeUsage 這個特性是用來標註特性的適用範圍的，其中AttributeTargets.Class | AttributeTargets.Method 表示這個特性是可以設置在類或者方法上的。AllMultiple表示是否允許設置多個，Inherited 表示被該特性標註的類其子類是否也自動繼承了這個特性。

那麼，我們瞭解了RouteAttribute的適用範圍，繼續看這個類，一共有三個屬性：

• Name 表示這個路由特性的名稱
• Order 表示啟用順序，值越小，越先被匹配。預設情況下是0
• Template 路由解析模板，也就是在《【asp.net core 系列】2 控制器與路由的恩怨情仇》中介紹的路由表的格式串

介紹了這麼多，我們先來試試看，先拿出來之前文章創建的MvcWeb項目，新建一個控制器：

using Microsoft.AspNetCore.Mvc;

namespace MvcWeb.Controllers
{
    public class RouteTestController: Controller
    {
        public IActionResult Index()
        {
            return View();
        }
    }
}

創建對應視圖：

Views > RouteTest > Index.cshtml

在Index.cshtml中隨便寫點內容，然後保存。

然後，在RouteTestController 添加一個Route特性標記：

[Route("/Route")]
public IActionResult Index()
{
    return View();
}

啟動項目，訪問 http://localhost:5006/Route 後，如果不出意外可以看到跟下圖類似的界面：

那麼我們試一試通過路由表設置的路徑是否可以訪問：

http://localhost:5006/RouteTest

可以看到提示404，也就是說這個Action無法通過路由表的形式查找到了。

1.2 設置參數

我們知道所謂的Action其實也是一個方法，而我們通常請求一個網址的時候，網址中也帶有一些查詢參數。所以，這一節我們就介紹一下路由特性（屬性路由）如何設置參數的解析吧。

1.2.1 不做任何操作

在RouteTestController里添加方法：

[Route("/route/norest")]
public IActionResult NoRest(string name)
{
    ViewBag.Name = name;
    return View();
}

創建對應的View：

<h1>@ViewBag.Name</h1>

啟動程式，並訪問：http://localhost:5006/route/norest

添加 ?name=test 在上一個請求的後面：

嘗試變更name的值，可以發現網頁中的值也發生了變化，證明我們可以獲取到這個值。

1.2.2 當做請求目錄的一部分

在上一小節中，沒有對參數做任何操作，以查詢參數的形式傳遞。在這一篇，我們可以把參數設置為請求的一部分，像目錄那樣，修改上一節示例代碼為：

[Route("/route/norest/{name}/")]
public IActionResult NoRest(string name)
{
    ViewBag.Name = name;
    return View();
}

請求方式：

http://localhost:5006/route/norest/1232

修改連接中的1232 內容，然後刷新頁面，就能發現頁面中的值也發生了變化

1.2.3 給參數一個預設值

之前的設置里我們都預設參數由請求URL獲取，那麼在這裡我們介紹一下給參數一個值：

[Route("/route/norest/{name=demo}/")]
public IActionResult NoRest(string name)
{
    ViewBag.Name = name;
    return View();
}

訪問連接：

http://localhost:5006/route/norest/

可以看見：

設置為可空，也就是參數可以不傳：

[Route("/route/norest/{name?}/")]
public IActionResult NoRest(string name)
{
    ViewBag.Name = name;
    return View();
}

訪問連接：

http://localhost:5006/route/norest/

可以看到頁面沒有任何顯示：

正常情況下，如果不對參數設置可空而且參數被我們當做目錄的一部分時，不給值是會提示404。

1.3 路由約束

2. 路由統一首碼

在第一節中，我們介紹瞭如何使用RouteAttribute為控制器里的方法標記路由信息。有時候會出現這樣的一個問題，一個控制器方法里可能會出現多個方法（Action）。通常情況下，我們要求一個控制器處理的請求應當有一個統一的首碼（或者稱之為URL目錄）。

那麼，這種情況我們仍然繼續使用 RouteAttribute，不過與之前不同的是，這次直接在控制器類上標記：

[Route("/Route")]
public class RouteCtrTestController: Controller
{
}
    

這時候，在方法上如果添加了RouteAttribute，設置的路由信息如果不是以/ 開始，則會將該Action的路由配置加到Controller後面。如果是以/ 開始，則表示該路由是根路由。

如果沒有設置RouteAttribute，則表示當前方法是處理控制器配置的路由的方法。

如果一個控制器里出現多個未設置RouteAttribute，則會出錯。

示例代碼如下：

[Route("/Route")]
public class RouteCtrTestController: Controller
{
    public int temp{get;set;}
    public IActionResult Index(int temp)
    {
        return Content($"你好{temp}");
    }
    [Route("Demo")]
    public IActionResult Demo()
    {
        return Content($"你好 Demo");
    }
}

2. 總結

今天的內容比較短，這裡介紹了一些路由的另一種用法，小伙伴們對此有個瞭解就可以了。下一篇將會到視圖，開始準備帶領大家做一個小項目啦。

更多內容煩請關註我的博客《高先生小屋》