ASP.NET Core 中的路由模板是如何定义的?

来源:这里教程网 时间:2026-02-21 17:26:50 作者:

在 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 的场景中,路由直接通过 MapGetMapPost 等扩展方法定义。

例如:
app.MapGet("/products/{id}", (int id) => { ... });

这表示当收到对
/products/5
的 GET 请求时,会调用对应的委托处理逻辑。
参数名称(如
id
)需与路径变量一致,框架会自动进行类型绑定。

路由模板中的占位符和约束

路由模板支持多种占位符和可选约束,提升灵活性和精确性。

[controller]
[action]
是预定义的替换标记,分别替换成实际的控制器名和操作名。
参数可用花括号包裹,如
{name}
{id?}
(问号表示可选)。
添加类型约束,如
{id:int}
{date:datetime}
,确保只有符合格式的请求才被匹配。

基本上就这些。路由模板的设计让 URL 结构清晰且易于维护,无论是传统 MVC 还是 Minimal API 风格都能灵活支持。

相关推荐