在 ASP.NET Core 中,路由模板用于定义 URL 的结构,并将传入的 HTTP 请求映射到相应的控制器或终结点。路由模板可以在控制器、操作方法上通过特性(Attribute)定义,也可以在程序启动时通过代码集中配置。
使用控制器和操作上的特性定义路由模板
通过 [Route] 和 [HttpXxx] 特性(如 [HttpGet]、[HttpPost])可以直接在控制器或操作方法上设置路由模板。
在控制器级别定义基础路径,例如:[Route("api/[controller]")] 表示该控制器下的所有操作都以 /api/控制器名开头。 在操作方法上进一步细化路由,例如:
[HttpGet("{id}")] 匹配类似 /api/users/123的 GET 请求。 支持通配符和约束,比如
{id:int} 只匹配整数类型的 ID。
在 Minimal API 中定义路由模板
在使用 Minimal API 的场景中,路由直接通过 MapGet、MapPost 等扩展方法定义。
例如:app.MapGet("/products/{id}", (int id) => { ... });这表示当收到对
/products/5的 GET 请求时,会调用对应的委托处理逻辑。 参数名称(如
id)需与路径变量一致,框架会自动进行类型绑定。
路由模板中的占位符和约束
路由模板支持多种占位符和可选约束,提升灵活性和精确性。
[controller]、
[action]是预定义的替换标记,分别替换成实际的控制器名和操作名。 参数可用花括号包裹,如
{name}、{id?}(问号表示可选)。
添加类型约束,如 {id:int}、{date:datetime},确保只有符合格式的请求才被匹配。
基本上就这些。路由模板的设计让 URL 结构清晰且易于维护,无论是传统 MVC 还是 Minimal API 风格都能灵活支持。
