当前位置: 移动技术网 > IT编程>开发语言>.net > ASP.NET Core Razor 页面路由详解

ASP.NET Core Razor 页面路由详解

2017年09月07日  | 移动技术网IT编程  | 我要评论

挥刀自宫是什么意思,原版xp sp3系统下载,哈根斯

 在服务器端 web 应用程序框架中,其中非常重要的设计是开发人员如何将url与服务器上的资源进行匹配,以便正确的处理请求。最简单的方法是将 url 映射到磁盘上的物理文件,在 razor 页面框架中,asp.net团队就是这样实现的。

关于 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;
  }
 }
}
<p>the id is @id</p>

如果您使用的是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
<p>the id is @model.id</p>

最后,您可以在公有属性使用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/applewww.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之间的匹配规则仍然正常运行。

总结

razor 页面中的路由系统非常直观,基于文件位置,但如果需要覆盖默认约定,它也非常强大,可配置。

原文:《routing in razor pages》

翻译:sweet tang

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持移动技术网。

如对本文有疑问,请在下面进行留言讨论,广大热心网友会与你互动!! 点击进行留言回复

相关文章:

验证码:
移动技术网