[譯]ASP.NET Core 2.0 路由引擎詳解
本文介紹了ASP.NET Core 2.0 路由引擎詳解，分享給大家，具體如下：
問題
ASP.NET Core 2.0的路由引擎是如何工作的？
答案
創(chuàng)建一個(gè)空項(xiàng)目，為Startup類添加MVC服務(wù)和請(qǐng)求中間件：
public void ConfigureServices(IServiceCollection services)
{
services.AddMvc();
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
app.UseMvc(routes =>
{
routes.MapRoute(
name: "goto_one",
template: "one",
defaults: new { controller = "Home", action = "PageOne" });
routes.MapRoute(
name: "goto_two",
template: "two/{id?}",
defaults: new { controller = "Home", action = "PageTwo" });
routes.MapRoute(
name: "default",
template: "{controller=Home}/{action=Index}/{id?}");
});
}
創(chuàng)建一個(gè)控制器HomeController，來演示常規(guī)路由：
public class HomeController : Controller
{
public IActionResult Index()
{
return Content("Home/Index");
}
public IActionResult PageOne()
{
return Content("Home/One");
}
[HttpGet]
public IActionResult PageTwo()
{
return Content("(GET) Home/Two");
}
[HttpPost]
public IActionResult PageTwo(int id)
{
return Content($"(POST) Home/Two: {id}");
}
}
創(chuàng)建一個(gè)控制器WorkController，來演示特性路由：
[Route("work")]
public class WorkController : Controller
{
public IActionResult Index()
{
return Content("Work/Index");
}
[Route("one")]
public IActionResult PageOne()
{
return Content("Work/One");
}
[HttpGet("two")]
public IActionResult PageTwo()
{
return Content("(GET) Work/Two");
}
[HttpPost("two/{id?}")]
public IActionResult PageTwo(int id)
{
return Content($"(POST) Work/Two: {id}");
}
}
討論
ASP.NET Core的路由引擎可以將傳入的請(qǐng)求映射到控制器和它們的方法中。這是通過向請(qǐng)求管道中添加路由中間件實(shí)現(xiàn)的，具體來說是使用IRouteBuilder將URL規(guī)則（模板）映射到一個(gè)控制器的方法。
路由模板
路由模板可以使用字面值和標(biāo)記（標(biāo)識(shí)路由參數(shù)）。在匹配一個(gè)路由時(shí)，字面值會(huì)嚴(yán)格匹配URL中的文本，而標(biāo)記會(huì)被替換掉。
為了匹配一個(gè)模板，模板中必須包含控制器和方法標(biāo)記以便定位控制器方法（這是MVC的核心信息）。模板中的其它標(biāo)記被映射為方法的參數(shù)（通過模型綁定實(shí)現(xiàn)）。
當(dāng)添加一個(gè)路由映射時(shí)，可以為標(biāo)記提供缺省值。當(dāng)模板中不包含控制器和方法標(biāo)記時(shí)會(huì)很有用。模板也可以包含對(duì)應(yīng)于方法參數(shù)的可選標(biāo)記。
讓我們來看一個(gè)示例模板：
contact/{controller=Home}/{action=Index}/{id?}
注意如下幾點(diǎn)：
1.標(biāo)記包含中大括號(hào)中。這里有三個(gè)標(biāo)記，分別是controller，action和id。
2.模板中包含一個(gè)字面值contact，它會(huì)匹配URL中的文本。
3.已經(jīng)為controller（Home）和action（Index）提供了默認(rèn)值。
4.可選標(biāo)記通過問號(hào)來聲明。
下面的URL會(huì)匹配這個(gè)模板：
- /contact/Home/Index/1: 所有標(biāo)記都有值。
- /contact/Home/Index: 忽略了可選標(biāo)記。
- /contact/Home: 忽略了action標(biāo)記，將使用默認(rèn)值Index。
- /contact: 忽略了controller和action標(biāo)記，將分別使用其默認(rèn)值Home和Index。
常規(guī)路由
常規(guī)路由為URL路徑建立一個(gè)約定, 例如給定一個(gè)模板:
1.第一個(gè)標(biāo)記映射到控制器
2.第二個(gè)標(biāo)記映射到方法
3.第三個(gè)標(biāo)記映射到可選的方法參數(shù)id
你也可以從模板中省略控制器和方法，只要你為它們提供缺省值就行了。比如下面的路由會(huì)映射到地址/one，因?yàn)橥ㄟ^defaults提供了所需的控制器和方法標(biāo)記：
routes.MapRoute(
name: "goto_one",
template: "one",
defaults: new { controller = "Home", action = "PageOne" });
注：請(qǐng)將此特定路由添加到通用路由之前，因?yàn)槁酚墒前凑斩x的順序執(zhí)行的，一旦某個(gè)路由匹配成功，則整個(gè)匹配流程就會(huì)終結(jié)。
由于路由中間件只使用了控制器和方法標(biāo)記來映射到一個(gè)控制器方法，因此同一個(gè)控制器中放置多個(gè)同名的的方法將會(huì)拋出異常。為了解決這個(gè)問題，可以使用方法上的IActionConstraint特性（比如HttpGet，HttpPost等特性）：
[HttpGet("two")]
public IActionResult PageTwo()
{
return Content("(GET) Work/Two");
}
[HttpPost("two/{id?}")]
public IActionResult PageTwo(int id)
{
return Content($"(POST) Work/Two: {id}");
}
====start by sanshi=========================
為了觀察控制器中同名方法出現(xiàn)的異常，我們首先需要修改Configure()方法，添加開發(fā)時(shí)異常處理中間件：
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
app.UseMvc(routes => ....);
}
修改HomeController：
public IActionResult PageTwo()
{
return Content("(GET) Home/Two");
}
public IActionResult PageTwo(int id)
{
return Content($"(POST) Home/Two: {id}");
}
看似很正常的重載函數(shù)，但是放到控制器中會(huì)拋出異常。
在瀏覽器地址欄敲入：http://localhost:65415/Home/PageTwo，觀看到異常頁面：
====end by sanshi=========================
特性路由
特性路由通過直接為控制器和方法提供路由模板來實(shí)現(xiàn)。
我們可以使用[Route]或者[HttpGet]（或者其他動(dòng)詞）特性來指定模板。這些模板可以包含字面值和標(biāo)記（不能包含控制器和方法標(biāo)記）。
運(yùn)行時(shí)，控制器的特性模板和方法的特性模板會(huì)被合并到一起，比如，在WorkController中，PageOne方法可以通過/work/one訪問：
[Route("work")]
public class WorkController : Controller
{
[Route("one")]
public IActionResult PageOne()
{
return Content("Work/One");
}
}
原文：https://tahirnaushad.com/2017/08/20/asp-net-core-mvc-routing/
以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。
相關(guān)文章
ASP.NET沒有魔法_ASP.NET MVC 模型驗(yàn)證方法
下面小編就為大家分享一篇ASP.NET沒有魔法_ASP.NET MVC 模型驗(yàn)證方法，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2018-02-02
asp.net中一次性動(dòng)態(tài)綁定多個(gè)droplistdown
asp.net中一次性動(dòng)態(tài)綁定多個(gè)droplistdown的實(shí)現(xiàn)代碼，需要的朋友可以參考下。2011-10-10
asp.net mvc webapi 實(shí)用的接口加密方法示例
本篇文章主要介紹了asp.net mvc webapi 實(shí)用的接口加密方法示例，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2017-10-10
Asp.net mvc實(shí)時(shí)生成縮率圖到硬盤
這篇文章主要介紹了Asp.net mvc實(shí)時(shí)生成縮率圖到硬盤的相關(guān)資料,需要的朋友可以參考下2016-05-05
這篇文章主要介紹了詳解ASP.NET MVC 下拉框的傳值的兩種方式，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-12-12
這篇文章主要介紹了ASP.NET中為GridView添加刪除提示框的方法,可實(shí)現(xiàn)非常人性化的刪除提示功能,需要的朋友可以參考下2015-06-06
asp.net SAF 中緩存服務(wù)的實(shí)現(xiàn)
對(duì)緩存的興趣源于張子陽寫的一篇文章《SAF 中緩存服務(wù)的實(shí)現(xiàn)》中的一個(gè)例子：2008-08-08
ASP.NET中在一般處理程序中使用session的簡(jiǎn)單介紹
這篇文章介紹了ASP.NET中在一般處理程序中使用session，有需要的朋友可以參考一下2013-10-10
Asp.Net服務(wù)器發(fā)送HTTP標(biāo)頭后無法設(shè)置內(nèi)容類型的問題解決
這篇文章主要給大家介紹了Asp.Net服務(wù)器發(fā)送HTTP標(biāo)頭后無法設(shè)置內(nèi)容類型問題的解決方法，文中介紹的非常詳細(xì)，對(duì)大家具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來一起看看吧。2017-05-05
MAUI使用Maui.Graphics.Controls繪制控件詳解
本文詳細(xì)講解了MAUI使用Maui.Graphics.Controls繪制控件的方法，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2022-02-02