ASP.NET MVC Route 基本題 - 如何自定 URL 的子目錄路徑

對於剛學習 ASP.NET MVC 的朋友來說，Route 設定是比較少去碰到的，甚至於有人會對於 Route 是不太清楚甚至於有些模糊，這一篇講個 ASP.NET MVC 初學者常會誤解的作法，哪就是設定 URL 的子目錄路徑，尤其是已有 ASP.NET WebForm 開發經驗的朋友會把以往的開發經驗給帶到 ASP.NET MVC 的開發上，所以在這邊說明一下。

 

---

在開發 ASP.NET WebForm 的時候，如果想要讓網站的 URL 目錄結構有階層性，可以在網站根目錄下去建立目錄然後再加入 ASPX 檔案，

那麼瀏覽此網頁的 URL 就會是「http:// 網站網址 / Products / Index.aspx」

如果繼續往下建立子目錄的話，URL 的目錄結構就會再增加一層，

 

可是在 ASP.NET MVC 的時候想要在 URL 的目錄結構去增加下一個階層目錄時，應該怎麼做呢？

剛接觸 ASP.NET MVC 開發的朋友在還沒有認識到 Route 之前或是認識不久的情況下，可能會直接以往在 ASP.NET WebForm 的經驗拿過來用，就會有以下的作法出現：

在 Controllers 目錄下手動增加「Product」資料夾，然後新增 ProductController.cs

然後也在 Views 目錄下的 Home 子目錄下去新增「Product」資料夾，然後新增 Index.cshtml

在完成以上的設定之後，輸入 URL 卻無法照著目錄結構去顯示正確的內容，

如果把 URL 裡的 Home 這一層拿掉卻又出現以下的錯誤，

出現上面的結果後就會開始尋找怎麼正確去顯示「~/Views/Home/Product/Index.cshtml」，也許會有人找到以下的方法來讓網頁可以執行並顯示，

But … 這樣的作法是正確的嗎？
MVC 所強調的已習慣取代配置、 Controller 與 View 的對應等等，怎麼好像有些怪怪的？

 

想要讓 ASP.NET MVC 網站的 URL 結構可以有子目錄（Sub Dictionary）的路徑結構，這必須要從 Route 裡去做設定，而不是直接從 Controllers 與 Views 裡去硬加入資料夾，ASP.NET MVC 與 ASP.NET WebForm 在這方面有很大的不同，在 ASP.NET MVC 裡可以藉由 Route 的設定讓我們可以自定義 URL 的呈現與執行的對應，讓網站 URL 不必拘泥於「網站目錄結構」的限制。

 

那麼 ASP.NET MVC 要怎麼去設定有階層的 URL 呢？這邊用一個簡單的例子來做說明，以上面的例子為例，想要呈現「http:// WebSite / Home / Product / Details」，

在 HomeController 增加一個 ProductDetails Action 方法，

接著再建立 Action 方法相對應的 View「ProductDetails.cshtml」

「~/Views/Home/Product.cshtml」

 

Controller 與 View 都準備好之後，再來就是要做 Route 的設定，開啟「~/App_Start/RouteConfig.cs」檔案，

開啟之後只會看到一個預設的 Route 設定

接著我們要在預設的 route 設定上面去加入新的 route 設定，ASP.NET MVC 的 Route 設定可以有很多個，不過每個 Route 設定的名稱不可以重複，另外就是 Route 設定的匹配是有順序性的，越上面的將會優先進行匹配，有匹配到符合的 Route 設定就會執行那一個 Route 的設定內容。

我增加了以下的 Route 設定內容，

Route 設定的名稱為「Home_Product_SubDictionary」

對應匹配的 URL 為「Home/Product/Details/{id}」

預設對應的 Controller 為「HomeController」Action 為「ProductDetails」

限制（constraints）為只有 Controller 是 Home 以及 Action 是 ProductDetails

 

執行結果：

 

以上的作法是我們需要去自定義 URL 結構時的一些基本的設定做法，當然想要做更為複雜的 URL 結構也是可以，不過那就比較屬於進階的內容了，可以查詢網路上的一些資訊，或是可以查閱「ASP.new MVC 4 網站開發美學」「Chapter.4 - ASP.NET Routing 串起 Controller 與 View 的磨法師」此章節的內容。

假如需要的是一個可以顯示管理後台的子目錄，因為管理後台會有很多的功能，也會有很多的 Controller 需要建立，那麼就不需要用這種作法，而是需要使用「Area 區域」的作法，相關內容可以參閱以下文章「ASP.NET MVC 使用 Area - 以 Backend 後台為例」。

 

其他有關 Route 設定的相關文章：

ASP.NET MVC 資料分頁與 Route - Part.1

ASP.NET MVC 資料分頁與 Route - Part.2

ASP.NET MVC 資料分頁與 Route - Part.3

ASP.NET MVC - LowercaseRoutesMVC 讓網站的 URL 輸出為小寫

 

以上