如何實(shí)現(xiàn)ASP.NET Core Razor頁(yè)面路由?針對(duì)這個(gè)問(wèn)題,這篇文章詳細(xì)介紹了相對(duì)應(yīng)的分析和解答,希望可以幫助更多想解決這個(gè)問(wèn)題的小伙伴找到更簡(jiǎn)單易行的方法。
10年的平?jīng)鼍W(wǎng)站建設(shè)經(jīng)驗(yàn),針對(duì)設(shè)計(jì)、前端、開(kāi)發(fā)、售后、文案、推廣等六對(duì)一服務(wù),響應(yīng)快,48小時(shí)及時(shí)工作處理。成都全網(wǎng)營(yíng)銷(xiāo)的優(yōu)勢(shì)是能夠根據(jù)用戶(hù)設(shè)備顯示端的尺寸不同,自動(dòng)調(diào)整平?jīng)鼋ㄕ镜娘@示方式,使網(wǎng)站能夠適用不同顯示終端,在瀏覽器中調(diào)整網(wǎng)站的寬度,無(wú)論在任何一種瀏覽器上瀏覽網(wǎng)站,都能展現(xiàn)優(yōu)雅布局與設(shè)計(jì),從而大程度地提升瀏覽體驗(yàn)。創(chuàng)新互聯(lián)從事“平?jīng)鼍W(wǎng)站設(shè)計(jì)”,“平?jīng)鼍W(wǎng)站推廣”以來(lái),每個(gè)客戶(hù)項(xiàng)目都認(rèn)真落實(shí)執(zhí)行。在服務(wù)器端 Web 應(yīng)用程序框架中,其中非常重要的設(shè)計(jì)是開(kāi)發(fā)人員如何將URL與服務(wù)器上的資源進(jìn)行匹配,以便正確的處理請(qǐng)求。最簡(jiǎn)單的方法是將 URL 映射到磁盤(pán)上的物理文件,在 Razor 頁(yè)面框架中,ASP.NET團(tuán)隊(duì)就是這樣實(shí)現(xiàn)的。
關(guān)于 Razor 頁(yè)面框架如何將 URL 與文件相匹配,有一些規(guī)則您必須了解,以及如何根據(jù)需要自定義規(guī)則改變輸出的結(jié)果。如果您將 Razor 頁(yè)面與 Web Form 框架進(jìn)行比較,您還需要了解取代的 Ur l參數(shù)以及在URL中傳遞數(shù)據(jù)的機(jī)制。
規(guī)則一,Razor 頁(yè)面需要一個(gè)根目錄。默認(rèn)情況下,該根目錄是 Pages,位于Web應(yīng)用程序項(xiàng)目的根目錄中。您可以在Startup
類(lèi)的ConfigureServices
方法中配置其它文件夾作為根目錄。以下是將根目錄更改為位于應(yīng)用程序 “Content” 文件夾:
public void ConfigureServices(IServiceCollection services) { services .AddMvc(). AddRazorPagesOptions(options => { options.RootDirectory = "/Content"; }); }
規(guī)則二,URL映射到Razor頁(yè)面,URL不包含文件擴(kuò)展名。
規(guī)則三,“Index.cshtml”是一個(gè)默認(rèn)文檔,這意味著如果
URL | 映射文件 |
---|---|
www.domain.com | /Pages/Index.cshtml |
www.domain.com/index | /Pages/Index.cshtml |
www.domain.com/index | /Pages/Index.cshtml |
www.domain.com/account | /Pages/account.cshtml 或者 /Pages/account/index.cshtml |
在最后一個(gè)例子中,URL映射到兩個(gè)不同的文件 - 根目錄中的“account.cshtml”、“account”文件夾中的“index.cshtml”。Razor 頁(yè)面框架無(wú)法識(shí)別要選擇哪一個(gè)文件,因此如果您在應(yīng)用程序中實(shí)際同時(shí)擁有這兩個(gè)文件,那么如果您嘗試瀏覽www.domain.com/account,會(huì)拋出如下異常:
AmbiguousActionException: Multiple actions matched. The following actions matched route data and had all constraints satisfied:
Page: /account/Index
Page: /account
URL傳遞參數(shù)
就像大多數(shù)其它框架一樣,參數(shù)可以作為查詢(xún)字符串在 URL 中傳遞,例如:www.domain.com/product?id=1
;或者,您可以將其作為路由參數(shù)傳遞,因此上述示例將變?yōu)?code>www.domain.com/product/1。URL的一部分必須映射到參數(shù)名稱(chēng),在頁(yè)面的路由模板來(lái)實(shí)現(xiàn)的,@page
指令的一部分:
@page "{id}"
該模板告訴框架將頁(yè)面名稱(chēng)之后URL的第一段作為“id”的路由參數(shù)。您可以通過(guò)多種方式訪問(wèn)路由參數(shù)的值。第一個(gè)是使用RouteData
字典:
@page "{id}" { var productId = RouteData.Values["id"]; }
或者,您可以向該頁(yè)面的OnGet()
方法添加與路由參數(shù)相同名稱(chēng)的參數(shù),并將其值分配給公共屬性:
@page "{id}" @{ @functions{ public int Id { get; set; } public void OnGet(int id) { Id = id; } } }The Id is @Id
如果您使用的是PageModel
,那么是這樣實(shí)現(xiàn)的:
using Microsoft.AspNetCore.Mvc.RazorPages; namespace RazorPages.Pages { public class ProductModel : PageModel { public int Id { get; set; } public void OnGet(int id) { Id = id; } } }
@page "{id}" @model ProductModelThe Id is @Model.Id
最后,您可以在公有屬性使用BindProperty
特性,并省略該OnGet
方法中的參數(shù)。Razor 文件內(nèi)容保持不變,但是PageModel
代碼略有更改:
using Microsoft.AspNetCore.Mvc.RazorPages; namespace RazorPages.Pages { public class ProductModel : PageModel { [BindProperty(SupportsGet = true)] public int Id { get; set; } public void OnGet() { } } }
約束
此外,在此示例中參數(shù)的約束是它必須有一個(gè)值。URL www.domain.com/product/apple
與www.domain.com/product/21
一樣有效,都是可以與路由匹配。如果您希望id
值為整數(shù),則可以通過(guò)將數(shù)據(jù)類(lèi)型添加到模板來(lái)指定約束:
@page "{id:int}"
現(xiàn)在,如果您嘗試通過(guò)“apple”作為參數(shù)值,應(yīng)用程序?qū)⒎祷?04 Not Found狀態(tài)碼。
您可以指定值不是必需的,可以將參數(shù)設(shè)置為可為空類(lèi)型:
@page "{id:int?}"
如果您的應(yīng)用程序允許使用“apple”作為參數(shù)值,則可以指定只允許使用A-Z和a-z的字符:
@page "{id:alpha}"
您可以與最小長(zhǎng)度要求相結(jié)合:
@page "{id:alpha:minlength(4)}"
更多的約束信息,可以查看微軟文檔。
友好URL
友好的URL能夠?qū)?URL 映射到磁盤(pán)上的任意文件,打破根據(jù)文件名一對(duì)一的映射關(guān)系。您可以使用這個(gè)特性來(lái)不改變 URL 以進(jìn)行SEO優(yōu)化而不能重命名文件的問(wèn)題,例如,如果希望所有請(qǐng)求由一個(gè)文件進(jìn)行處理。友好 URL 在Startup
類(lèi)型的ConfigureServices
方法中配置,調(diào)用RazorPagesOption
類(lèi)的AddPageRoute
方法。以下示例將 URL www.domain.com/product
映射到Razor 頁(yè)面 “extras”文件夾“products.cshtml”文件:
public void ConfigureServices(IServiceCollection services) { services .AddMvc() .AddRazorPagesOptions(options => { options.Conventions.AddPageRoute("/extras/products", "product"); }); }
如果您在 Web Forms 中使用過(guò)友好 URL,則應(yīng)注意AddPageRoute
方法的參數(shù)順序與 Web Forms MapPageRoute
方法相反,文件路徑作為第一個(gè)參數(shù)。此外,AddPageRoute
將路由模板作為第二參數(shù),而不是路由定義,其中任何約束被單獨(dú)定義。
最后一個(gè)例子說(shuō)明將所有請(qǐng)求映射到單個(gè)文件。如果站點(diǎn)內(nèi)容存儲(chǔ)在特定位置(數(shù)據(jù)庫(kù),Markdown文件),并且由單個(gè)文件(例如 “index.cshtml” )負(fù)責(zé)根據(jù) URL 定位內(nèi)容,然后將其處理為HTML,則可以執(zhí)行此操作:
public void ConfigureServices(IServiceCollection services) { services .AddMvc() .AddRazorPagesOptions(options => { options.Conventions.AddPageRoute("/index", "{*url}"); }); }
路由模板(*)通配符表示“全部”。即使使用此配置,磁盤(pán)上的現(xiàn)有文件和URL之間的匹配規(guī)則仍然正常運(yùn)行。
總結(jié)
Razor 頁(yè)面中的路由系統(tǒng)非常直觀,基于文件位置,但如果需要覆蓋默認(rèn)約定,它也非常強(qiáng)大,可配置。
關(guān)于如何實(shí)現(xiàn)ASP.NET Core Razor頁(yè)面路由問(wèn)題的解答就分享到這里了,希望以上內(nèi)容可以對(duì)大家有一定的幫助,如果你還有很多疑惑沒(méi)有解開(kāi),可以關(guān)注創(chuàng)新互聯(lián)成都網(wǎng)站設(shè)計(jì)公司行業(yè)資訊頻道了解更多相關(guān)知識(shí)。
另外有需要云服務(wù)器可以了解下創(chuàng)新互聯(lián)scvps.cn,海內(nèi)外云服務(wù)器15元起步,三天無(wú)理由+7*72小時(shí)售后在線,公司持有idc許可證,提供“云服務(wù)器、裸金屬服務(wù)器、高防服務(wù)器、香港服務(wù)器、美國(guó)服務(wù)器、虛擬主機(jī)、免備案服務(wù)器”等云主機(jī)租用服務(wù)以及企業(yè)上云的綜合解決方案,具有“安全穩(wěn)定、簡(jiǎn)單易用、服務(wù)可用性高、性?xún)r(jià)比高”等特點(diǎn)與優(yōu)勢(shì),專(zhuān)為企業(yè)上云打造定制,能夠滿(mǎn)足用戶(hù)豐富、多元化的應(yīng)用場(chǎng)景需求。