ASP.NET Core 中的自定义路由约束如何创建？

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 行业资讯

ASP.NET Core 中的自定义路由约束如何创建？

2025-09-26

浏览次数：次

返回列表

创建自定义路由约束需实现IRouteConstraint接口，注册到ConstraintMap，并在路由模板中使用，如{param:even}，以精确控制匹配逻辑，常见于格式校验场景。

asp.net core 中的自定义路由约束如何创建？

在 ASP.NET Core 中创建自定义路由约束，可以让你更精确地控制 URL 路由匹配逻辑。比如你希望某个路由参数必须是有效的邮政编码、手机号或特定格式的字符串，就可以通过自定义约束实现。

1. 创建自定义路由约束类

自定义路由约束需要实现 IRouteConstraint 接口。该接口只有一个方法 Match，用于判断参数是否符合规则。

例如，创建一个检查参数是否为偶数的约束：

public class EvenNumberConstraint : IRouteConstraint
{
    public bool Match(
        HttpContext httpContext,
        IRouter route,
        string routeKey,
        RouteValueDictionary values,
        RouteDirection routeDirection)
    {
        if (values.TryGetValue(routeKey, out var value))
        {
            var parameter = value?.ToString();
            if (int.TryParse(parameter, out int number))
            {
                return number % 2 == 0;
            }
        }
        return false;
    }
}

2. 注册自定义约束

在 Program.cs 或 Startup.cs 中注册这个约束，使其可以在路由模板中使用。

在 Program.cs 的服务配置中添加：

builder.Services.AddSingleton();

// 或者更推荐的方式：注册为具名约束 builder.Services.Configure(options => { options.ConstraintMap.Add("even", typeof(Even)Constraint)); });