如何在 ASP.NET Core 中强制执行小写路由？

Question

在 ASP.NET 4 中，这与应用程序的 RegisterRoutes 处理程序中的 routes.LowercaseUrls = true; 一样简单。

我在 ASP.NET Core 中找不到实现此目的的等效项。我想它会在这里：

app.UseMvc(configureRoutes =>
{
    configureRoutes.MapRoute("Default", "{controller=App}/{action=Index}/{id?}");
});

但是configureRoutes 中的任何内容似乎都不允许...除非在某个地方有我在文档中找不到的扩展方法？

Answer 1

对于 ASP.NET Core：

在Startup 类的ConfigureServices 方法中添加以下行之一：

services.AddRouting(options => options.LowercaseUrls = true);

或

services.Configure<RouteOptions>(options => options.LowercaseUrls = true); 

感谢 Skorunka 作为评论的回答。我认为值得推广为实际答案。

Answer 2

在 ASP.NET Core 版本中更新 >= 2.2

从 ASP.NET Core 2.2 开始，除了 lowercase，您还可以使用 ConstraintMap 使您的 路由虚线，这将使您的路由/Employee/EmployeeDetails/1 到 /employee/employee-details/1 而不是 /employee/employeedetails/1。

为此，首先创建SlugifyParameterTransformer类应该如下：

public class SlugifyParameterTransformer : IOutboundParameterTransformer
{
    public string TransformOutbound(object value)
    {
        // Slugify value
        return value == null ? null : Regex.Replace(value.ToString(), "([a-z])([A-Z])", "$1-$2").ToLower();
    }
}

对于 ASP.NET Core 2.2 MVC：

在Startup 类的ConfigureServices 方法中：

services.AddRouting(option =>
{
    option.ConstraintMap["slugify"] = typeof(SlugifyParameterTransformer);
});

并且Route配置应该如下：

app.UseMvc(routes =>
{
     routes.MapRoute(
        name: "default",
        template: "{controller:slugify}/{action:slugify}/{id?}",
        defaults: new { controller = "Home", action = "Index" });
});

对于 ASP.NET Core 2.2 Web API：

在Startup类的ConfigureServices方法中：

public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc(options => 
    {
        options.Conventions.Add(new RouteTokenTransformerConvention(new SlugifyParameterTransformer()));
    }).SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
}

对于 ASP.NET Core >=3.0 MVC：

在Startup类的ConfigureServices方法中：

services.AddRouting(option =>
{
    option.ConstraintMap["slugify"] = typeof(SlugifyParameterTransformer);
});

并且Route配置应该如下：

app.UseEndpoints(endpoints =>
{
      endpoints.MapAreaControllerRoute(
          name: "AdminAreaRoute",
          areaName: "Admin",
          pattern: "admin/{controller:slugify=Dashboard}/{action:slugify=Index}/{id:slugify?}");

      endpoints.MapControllerRoute(
          name: "default",
          pattern: "{controller:slugify}/{action:slugify}/{id:slugify?}",
          defaults: new { controller = "Home", action = "Index" });
});

对于 ASP.NET Core >=3.0 Web API：

在Startup 类的ConfigureServices 方法中：

services.AddControllers(options => 
{
    options.Conventions.Add(new RouteTokenTransformerConvention(new SlugifyParameterTransformer()));
});

对于 ASP.NET Core >=3.0 Razor 页面：

在Startup类的ConfigureServices方法中：

services.AddRazorPages(options => 
{
    options.Conventions.Add(new PageRouteTransformerConvention(new SlugifyParameterTransformer()));
})

这将使/Employee/EmployeeDetails/1 路由到/employee/employee-details/1

Answer 3

正如其他答案所示，添加：

services.Configure<RouteOptions>(options => options.LowercaseUrls = true);

之前

services.AddMvc(...)

效果很好，但我还想补充一点，如果您使用 Identity，您还需要：

services.AddIdentity<IdentityUser, IdentityRole>(options =>
{
    var appCookie = options.Cookies.ApplicationCookie;
    appCookie.LoginPath = appCookie.LoginPath.ToString().ToLowerInvariant();
    appCookie.LogoutPath = appCookie.LogoutPath.ToString().ToLowerInvariant();
    appCookie.ReturnUrlParameter = appCookie.ReturnUrlParameter.ToString().ToLowerInvariant();
});

显然，如果需要，请将 IdentityUser 和 IdentityRole 替换为您自己的类。

我刚刚使用 .NET Core SDK 1.0.4 和 1.0.5 运行时对此进行了测试。

Answer 4

找到了解决办法。

在程序集：Microsoft.AspNet.Routing 和 Microsoft.Extensions.DependencyInjection 命名空间中，您可以在 ConfigureServices(IServiceCollection services) 方法中执行此操作：

services.ConfigureRouting(setupAction =>
{
    setupAction.LowercaseUrls = true;
});

Answer 5

值得注意的是设置：

services.Configure<RouteOptions>(options => options.LowercaseUrls = true);

不影响查询字符串。

为确保查询字符串也是小写，请将options.LowercaseQueryStrings 设置为true：

services.Configure<RouteOptions>(options => 
{ 
    options.LowercaseUrls = true; 
    options.LowercaseQueryStrings = true;
});

但是，将此属性设置为 true 仅在 options.LowercaseUrls 也是 true 时才相关。如果options.LowercaseUrls 是false，则options.LowercaseQueryStrings 属性将被忽略。

Answer 6

对于身份，@Jorge Yanes Diez 答案在ASP.NET Core 2.2 中不起作用（我认为是 2.x），所以如果你在这里使用 Identity 和 ASP.NET Core 2.2 (2.x)是解决方案：

services.ConfigureApplicationCookie(options =>
{
    options.LoginPath = "/account/login";
    options.ReturnUrlParameter = "returnurl";
    ...
});

参考：Configure ASP.NET Core Identity

Answer 7

我在 RegisterRoutes::RouteConfig: 上有这个：

routes.LowercaseUrls = true;