- A+
概述
IPageRouteModelConvention接口用于自定义PageRouteModel，这个对象在Microsoft.AspNetCore.Mvc.ApplicationModels命名空间中，
代表着Razor Page路由设置，换句话说我们可以通过实现该接口覆盖默认的实现。
该接口需要实现一个成员void Apply(PageRouteModel model)。通过这个方法，我们可以访问有关当前路由设置的元数据，并根据需要对其内容进行修改。
下面示例，将解决提供一个伪静态的解决方案，因此我们可以通过index.html about.html....去访问我们的页面，也就是说我们可以从Index-Index.html的支持
public class HtmlExtensionPageRouteModelConvention : IPageRouteModelConvention { private readonly ILogger _logger; public HtmlExtensionPageRouteModelConvention(ILogger logger) { _logger = logger; } public void Apply(PageRouteModel model) { var log = new StringBuilder(); log.AppendLine("===================================================="); log.AppendLine($"Count：{model.Selectors.Count} ViewEnginePath：{model.ViewEnginePath} RelativePath：{model.RelativePath}"); var selectorsCount = model.Selectors.Count; for (var i = 0; i < selectorsCount; ++i) { var attributeRouteModel = model.Selectors[i].AttributeRouteModel; //添加之前 log.AppendLine($"Template：{attributeRouteModel.Template}"); if (string.IsNullOrEmpty(attributeRouteModel.Template)) { continue; } //该规则是否禁止链接的生成，默认为生成(支持TagHelpers) asp-page="/Index" attributeRouteModel.SuppressLinkGeneration = true; //添加新的路由模板 model.Selectors.Add(new SelectorModel { AttributeRouteModel = new AttributeRouteModel { //Order 路由匹配顺序 //SuppressLinkGeneration = true, Template = $"{attributeRouteModel.Template}.html", } }); } //添加完后 log.AppendLine($"Count：{model.Selectors.Count} "); foreach (var item in model.Selectors) { log.AppendLine($"Template：{item.AttributeRouteModel.Template} "); } _logger.LogInformation(log.ToString()); } } 在启动时，为所有可导航的Razor页面构建PageRouteModel。Apply方法接收这个对象，并访问于PageRouteModel相关联的SelectorModel对象集合。它们包含页面路由和任何约束的信息，在每个页面的selector集合中通常有一个SelectorModel，但可以有任意数量，默认页面为Index.cshtml通常有两个选择器，一个包含一个路由模板，由相对文件路径和"Index"组成，另一个模板中有一个空字符串，文件名通常放在那里（这使它成为文件夹的默认文件）。在这个例子中的Index.cshtml原始模板生成的(Index)，将变成一个Index.html
我们需要将attributeRouteModel.SuppressLinkGeneration设置为true,禁止对链接的生成，默认值为false(支持TagHelpers如：asp-page="/Index"),
如下图所示鼠标箭头放到Home上面，在下面可以显示出来为我们生成的路径，这个路由则是根据我们设置的规则而生成出来的.
当我们在Selectors.Add方法内中的new AttributeRouteModel对象中将SuppressLinkGeneration设置为true，这样的话我们是将路由规则设置禁止了，看下图可以看出，
当我们把所有的规则都设置为禁止生成后，我们当鼠标剪头再次放到Home上面时已经不会为我们再生成新的链接了
添加约定
自定义约定要在Startup中的void ConfigureServices(IServiceCollection services)方法下中的 services.AddRazorPages()方法下追加RazorPagesOptions方法并添加约定的集合：
public void ConfigureServices(IServiceCollection services) { ... services.AddRazorPages().AddRazorPagesOptions(options => { //options.Conventions.AddPageRoute("/Index", "Index.html"); options.Conventions.Add(new HtmlExtensionPageRouteModelConvention(_loggerFactory.CreateLogger<HtmlExtensionPageRouteModelConvention>())); }); } 通过如上代码，我们便在.NET中实现了伪静态，对URL路由匹配规则的附加操作.
https://github.com/hueifeng/BlogSample/tree/master/src/PageRouteModelConventionURLRewrite
