asp.net core 系列 7 Razor框架路由(上)

 

一.概述

  在上二篇中,主要是介绍了asp.net core mvc中路由的使用,这篇继续介绍路由在ASP.NET Core Razor中的使用。Razor Pages应该使用默认的传统路由,从应用程序的Pages文件夹中提供命令资源。还可以使用其他约定来自定义 Razor Pages 路由行为。

  在ASP.NET Core MVC 中是使用路由中间件来匹配传入请求的 URL 并将它们映射到操作(action)。而ASP.NET Core  Razor使用页面路由和应用模型提供程序约定,来控制 Razor 页面应用中的页面路由、发现和处理。

  使用AddRazorPagesOptions 扩展方法向 Startup 类中服务集合的 AddMvc 服务中添加和配置 Razor 页面约定。

复制代码
            services.AddMvc()                 .SetCompatibilityVersion(CompatibilityVersion.Version_2_2)                 .AddRazorPagesOptions(options=> {                       //添加razor页面路由和应用模型约定                     //options.Conventions.Add();                });
复制代码

  在ASP.NET Core 的 Razor框架页面中,路由和应用的约定有四大类。都需要实现IPageConvention接口。在MVC框架下路由需要实现IRouteBuilder接口。

 

  (1) 模型约定 Conventions.Add

    通过Conventions.Add添加的模型约定(Model conventions)。作用是:将路由模板和标头(page header)添加到应用的页面。模型约定有三种实现的接口IPageRouteModelConvention(路由模型约定)、IPageApplicationModelConvention(应用模型约定)、IPageHandlerModelConvention(处理程序模型约定)。

 

  (2)  页面路由操作约定  Page route action conventions

    通过页面路由操作约定。作用是:可以将路由模板添加到某个文件夹中的页面以及单个页面。AddFolderRouteModelConvention(文件夹路由模型约定)、AddPageRouteModelConvention(页面路由模型约定)AddPageRoute(配置页面路由)

 

  (3) 页面模型操作约定 Page model action conventions

    通过页面模型操作约定。作用是:可以将标头添加到某个文件夹中的多个页面,将标头添加到单个页面,以及配置筛选器工厂以将标头添加到应用的页面  

AddFolderApplicationModelConvention(文件夹应用模型约定) AddPageApplicationModelConvention(页面应用模型约定) ConfigureFilter(配置筛选器)

 

  (4) 默认页面应用模型提供程序 Default page app model provider

    用户可以从默认模型提供程序继承,以便为处理程序发现和处理提供自己的实现逻辑 。

二. 模型约定

  为IPageConvention添加委托,以添加应用于 Razor 页面的模型约定。

 

  2.1  IPageRouteModelConvention

    将路由模型约定添加到所有页面。使用约定创建IPageRouteModelConvention并将其添加到IPageConvention实例集合中,这些实例将在页面路由模型构造过程中应用。下面示例应用将 {globalTemplate?} 路由模板添加到应用中的所有页面。

复制代码
    /// <summary>    /// 只在程序启动时调用(每页面路由对应执行一次apply)     /// </summary>    public class GlobalTemplatePageRouteModelConvention : IPageRouteModelConvention     {         ///<summary>        ///运用到所有页面路由模型中,制定页面路由模板,比如访问index页。         ///路由模板可以是/index 也可以是/index/{可选参数}         ///</summary>        ///<param name="model"></param>        public void Apply(PageRouteModel model)         {             var selectorCount = model.Selectors.Count;             for (var i = 0; i < selectorCount; i++)             {                 var selector = model.Selectors[i];                 model.Selectors.Add(new SelectorModel                 {                     AttributeRouteModel = new AttributeRouteModel                     {                         //执行路由顺序                        Order = 1,                         //页面路由模板                        Template = AttributeRouteModel.CombineTemplates(selector.AttributeRouteModel.Template,"{globalTemplate?}")                     }                 });              }         }     }
复制代码

    将 MVC 添加到Startup.ConfigureServices中的服务集合时,会添加 Razor 页面选项,例如:添加上面的约定。

复制代码
            services.AddMvc()                     .AddRazorPagesOptions(options =>                     {                         options.Conventions.Add(new GlobalTemplatePageRouteModelConvention());                     })                     .SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
复制代码

    在about页绑定 @RouteData.Values["globalTemplate"]。如果在浏览器访问: /about/glo

50000+
5万行代码练就真实本领
17年
创办于2008年老牌培训机构
1000+
合作企业
98%
就业率

联系我们

电话咨询

0532-85025005

扫码添加微信