ASP.NET Core Razor 页面路由详解
2019-12-08 16:00:16来源:爱站网 阅读 ()
服务器端Web应用最重要的就是服务器上的资源进行匹配,从而正确地处理请求,本文是爱站技术频道小编为大家带来的ASP.NET Core Razor 页面路由详解,希望能帮到您。
关于 Razor 页面框架如何将 URL 与文件相匹配,有一些规则您必须了解,以及如何根据需要自定义规则改变输出的结果。如果您将 Razor 页面与 Web Form 框架进行比较,您还需要了解取代的 Ur l参数以及在URL中传递数据的机制。
规则一,Razor 页面需要一个根目录。默认情况下,该根目录是 Pages,位于Web应用程序项目的根目录中。您可以在Startup
类的ConfigureServices
方法中配置其它文件夹作为根目录。以下是将根目录更改为位于应用程序 “Content” 文件夹:
public void ConfigureServices(IServiceCollection services) { services .AddMvc(). AddRazorPagesOptions(options => { options.RootDirectory = "/Content"; }); }
规则二,URL映射到Razor页面,URL不包含文件扩展名。
规则三,“Index.cshtml”是一个默认文档,这意味着如果
?
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 |
在最后一个例子中,URL映射到两个不同的文件 - 根目录中的“account.cshtml”、“account”文件夹中的“index.cshtml”。Razor 页面框架无法识别要选择哪一个文件,因此如果您在应用程序中实际同时拥有这两个文件,那么如果您尝试浏览www.domain.com/account,会抛出如下异常:
AmbiguousActionException: Multiple actions matched. The following actions matched route data and had all constraints satisfied:
Page: /account/Index
Page: /account
URL传递参数
就像大多数其它框架一样,参数可以作为查询字符串在 URL 中传递,例如:www.domain.com/product?id=1
;或者,您可以将其作为路由参数传递,因此上述示例将变为www.domain.com/product/1
。URL的一部分必须映射到参数名称,在页面的路由模板来实现的,@page
指令的一部分:
@page "{id}"
该模板告诉框架将页面名称之后URL的第一段作为“id”的路由参数。您可以通过多种方式访问路由参数的值。第一个是使用RouteData
字典:
@page "{id}" { var productId = RouteData.Values["id"]; }
或者,您可以向该页面的OnGet()
方法添加与路由参数相同名称的参数,并将其值分配给公共属性:
@page "{id}" @{ @functions{ public int Id { get; set; } public void OnGet(int id) { Id = id; } } }
The Id is @Id
如果您使用的是PageModel
,那么是这样实现的:
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 ProductModel
The Id is @Model.Id
最后,您可以在公有属性使用BindProperty
特性,并省略该OnGet
方法中的参数。Razor 文件内容保持不变,但是PageModel
代码略有更改:
using Microsoft.AspNetCore.Mvc.RazorPages; namespace RazorPages.Pages { public class ProductModel : PageModel { [BindProperty(SupportsGet = true)] public int Id { get; set; } public void OnGet() { } } }
约束
此外,在此示例中参数的约束是它必须有一个值。URL www.domain.com/product/apple
与www.domain.com/product/21
一样有效,都是可以与路由匹配。如果您希望id
值为整数,则可以通过将数据类型添加到模板来指定约束:
@page "{id:int}"
现在,如果您尝试通过“apple”作为参数值,应用程序将返回404 Not Found状态码。
您可以指定值不是必需的,可以将参数设置为可为空类型:
@page "{id:int?}"
如果您的应用程序允许使用“apple”作为参数值,则可以指定只允许使用A-Z和a-z的字符:
@page "{id:alpha}"
您可以与最小长度要求相结合:
@page "{id:alpha:minlength(4)}"
更多的约束信息,可以查看微软文档。
友好URL
友好的URL能够将 URL 映射到磁盘上的任意文件,打破根据文件名一对一的映射关系。您可以使用这个特性来不改变 URL 以进行SEO优化而不能重命名文件的问题,例如,如果希望所有请求由一个文件进行处理。友好 URL 在Startup
类型的ConfigureServices
方法中配置,调用RazorPagesOption
类的AddPageRoute
方法。以下示例将 URL www.domain.com/product
映射到Razor 页面 “extras”文件夹“products.cshtml”文件:
public void ConfigureServices(IServiceCollection services) { services .AddMvc() .AddRazorPagesOptions(options => { options.Conventions.AddPageRoute("/extras/products", "product"); }); }
如果您在 Web Forms 中使用过友好 URL,则应注意AddPageRoute
方法的参数顺序与 Web Forms MapPageRoute
方法相反,文件路径作为第一个参数。此外,AddPageRoute
将路由模板作为第二参数,而不是路由定义,其中任何约束被单独定义。
最后一个例子说明将所有请求映射到单个文件。如果站点内容存储在特定位置(数据库,Markdown文件),并且由单个文件(例如 “index.cshtml” )负责根据 URL 定位内容,然后将其处理为HTML,则可以执行此操作:
public void ConfigureServices(IServiceCollection services) { services .AddMvc() .AddRazorPagesOptions(options => { options.Conventions.AddPageRoute("/index", "{*url}"); }); }
路由模板(*)通配符表示“全部”。即使使用此配置,磁盘上的现有文件和URL之间的匹配规则仍然正常运行。
本文是爱站技术频道小编为大家带来的ASP.NET Core Razor 页面路由详解,由于razor页面中的路由系统非常直观,但是如果您需要重写默认约定,它也非常强大和可配置。
原文链接:https://js.aizhan.com/develop/aspnet/10594.html
如有疑问请与原作者联系
标签:
版权申明:本站文章部分自网络,如有侵权,请联系:west999com@outlook.com
特别注意:本站所有转载文章言论不代表本站观点,本站所提供的摄影照片,插画,设计作品,如需使用,请与原作者联系,版权归原作者所有
- asp.net源程序编译为dll文件并调用的实现过程 2020-03-29
- Asp.net MVC SignalR来做实时Web聊天实例代码 2020-03-29
- ASP.NET MVC中jQuery与angularjs混合应用传参并绑定数据 2020-03-29
- Asp.Net中WebForm的生命周期 2020-03-29
- ASP.NET使用Ajax返回Json对象的方法 2020-03-23
IDC资讯: 主机资讯 注册资讯 托管资讯 vps资讯 网站建设
网站运营: 建站经验 策划盈利 搜索优化 网站推广 免费资源
网络编程: Asp.Net编程 Asp编程 Php编程 Xml编程 Access Mssql Mysql 其它
服务器技术: Web服务器 Ftp服务器 Mail服务器 Dns服务器 安全防护
软件技巧: 其它软件 Word Excel Powerpoint Ghost Vista QQ空间 QQ FlashGet 迅雷
网页制作: FrontPages Dreamweaver Javascript css photoshop fireworks Flash