首页 > 常见问题 > 正文

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

月夜之吻
发布: 2025-09-26 08:31:01
原创
558人浏览过
创建自定义路由约束需实现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.csStartup.cs 中注册这个约束,使其可以在路由模板中使用。

Program.cs 的服务配置中添加:

builder.Services.AddSingleton<IRouteConstraint, EvenNumberConstraint>();

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

3. 在路由中使用自定义约束

注册后,你可以在控制器路由或 Razor Pages 中使用这个约束。

自由画布
自由画布

百度文库和百度网盘联合开发的AI创作工具类智能体

自由画布 73
查看详情 自由画布

例如,在控制器中:

[Route("api/values/{id:even}")] public IActionResult GetById(int id) {     return Ok(new { Id = id }); }

这样,只有当 id 是偶数时,该路由才会匹配。例如:

  • /api/values/4 → 匹配
  • /api/values/3 → 404

也可以用在 MapControllerRouteMapGet 等终结点配置中:

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

常见应用场景

自定义约束适合以下场景:

  • 验证参数是否为 GUID
  • 检查是否是手机号、邮箱、邮政编码等格式
  • 限制值在某个枚举范围内(如 {action:in(create,edit,delete)})
  • 日期格式校验

基本上就这些。只要实现接口、注册、并在路由中使用,就能灵活控制路由匹配行为。不复杂但容易忽略的是注册步骤——别忘了加到 ConstraintMap 里。

以上就是ASP.NET Core 中的自定义路由约束如何创建?的详细内容,更多请关注php中文网其它相关文章!

路由优化大师
路由优化大师

路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号