###### tags: `MVC`

# MVC Routing
## Route
路由定義 URL 模式和處理應用程序資訊。應用程序的所有已配置路由都存在 RouteTable 中，當請求傳入時，路由引擎將使用它來判斷合適的處理程序類別或檔案。


## Configure a Route
### App_Start\RouteConfig.cs


### routes.IgnoreRoute
用來定義不要透過 Routing 處理的網址，例如: 不會處理網址 localhost/test.axd/abc/123。
(* 表示後面無論接幾個路徑，如:/xxx/xxx 或/xxx/xxx/xxx 皆不處理)

### routes.MapRoute
* name: Route 的名稱，必須是唯一的。
* url: 具名參數定義 URL 樣式與每個路徑段落(PathSegment)的 Route Value 參數名稱。
* defaults: 具名參數定義各 RouteValue 路由參數的預設值，當網址路由比對不到 HTTP 要求的網址時，會先嘗試帶入這裡定義的預設值，然後再進一步比對是否有符合的 Controller 和 Action 可以執行。

`id = UrlParameter.Optional`，id 路由參數為選擇性，如果沒有為空值。

//RouteConfig.cs

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 }
        );
    }
}

## URL Pattern
* `{controller}/{action}/{id}`表示定義的 URL 樣式包含三個路由參數，分別命名為 controller、action 與 id。
* 網址路徑只有 `localhost`，那預設的路由為 `localhost/home/index`。
* 網址路徑為 `/Home/About/123`，那 controller 的路由值是 **Home**，action 的路由值是 **About**，而 id 這個路由值就是 123。


## Multiple Routes
* 路由順序由上到下匹配。
* 自訂路由 `url: customer/who/{id}`。
* 沒有加`id = UrlParameter.Optional`，表示網址必須要有路由參數 id。
* 網址 `http://localhost/customer/who/100`，路由比對為 **Customer** Controller 的 Action **Who**。

//RouteConfig.cs

public class RouteConfig
{
    public static void RegisterRoutes(RouteCollection routes)
    {
        routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
        //自訂路由
        routes.MapRoute(
            name: "Customer",
            url: "customer/who/{id}",
            defaults: new { controller = "Customer", action = "Who"}			
        );
				
        //預設路由
        routes.MapRoute(
            name: "Default",
            url: "{controller}/{action}/{id}",
            defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
        );
    }
}

## Route Constraints
限制路由參數 id 只能是數字。

//RouteConfig.cs

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

        routes.MapRoute(
            name: "Customer",
            url: "customer/who/{id}",
            defaults: new { controller = "Customer", action = "Index"},	
            constraints: new { id = @"\d+" } //限制 id 路由參數只能是數字
        );
		
        routes.MapRoute(
            name: "Default",
            url: "{controller}/{action}/{id}",
            defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
        );
    }
} 

## Register Routes
要在 Global.asax.cs 的 Application_Start 註冊 RouteConfig.cs，將所有路由包含到 RouteTable 中。

//Global.asax.cs

public class MvcApplication : System.Web.HttpApplication
{
    protected void Application_Start()
    {
        RouteConfig.RegisterRoutes(RouteTable.Routes);
    }
}

> 參考資料 [ASP.NET MVC Tutorials](https://www.tutorialsteacher.com/mvc/routing-in-mvc)