.NET Web API 路由通过MapControllers()启用，支持传统路由和属性路由；传统路由在Program.cs中配置全局模板，如”api/{controller}/{action}/{id?}”，适用于固定结构；属性路由使用[Route]、[HttpGet]等特性直接在控制器或方法上定义路径，更灵活且符合RESTful设计，推荐用于现代开发。
.NET Web API 的路由（Routing）是决定 HTTP 请求如何映射到控制器中具体操作方法的核心机制。合理配置路由，可以让 API 接口结构清晰、易于维护，并支持 RESTful 风格设计。本文将详细介绍 .NET 中 Web API 路由的配置方式，包括传统路由、属性路由以及混合使用场景。
启用路由与基础配置
在 .NET Web API 项目中，路由通常在 Program.cs 或 Startup.cs 文件中配置。从 .NET 6 开始，推荐在 Program.cs 中进行集中配置。
要启用 Web API 路由，需确保调用 MapControllers() 方法：
builder.Services.AddControllers();
app.MapControllers();
这行代码启用了基于控制器的路由，并自动扫描带有 [ApiController] 特性的控制器类。
传统路由（Convention-based Routing）
传统路由通过在程序启动时定义 URL 模板来匹配请求。适用于早期 ASP.NET Web API 项目，现在仍可使用。
示例：配置一个默认路由模板
app.UseRouting();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllerRoute(
name: “default”,
pattern: “api/{controller}/{action}/{id?}”
);
});api/ 是所有 API 的前缀 {controller} 映射到控制器名称（不含 Controller 后缀） {action} 映射到具体的方法名 id? 表示可选参数
例如，请求 GET /api/users/get/123 将调用 UsersController 中的 Get(int id) 方法。
属性路由（Attribute Routing）
属性路由是目前推荐的方式，通过在控制器或方法上添加 [Route]、[HttpGet] 等特性来定义路径，更加灵活且符合 RESTful 设计。
在控制器上使用 [Route] 定义基路径：
[ApiController]
[Route(“api/[controller]”)]
public class UsersController : ControllerBase
{
[HttpGet] // GET: api/users
public IActionResult GetAll() => Ok();
[HttpGet(“{id}”)] // GET: api/users/5
public IActionResult GetById(int id) => Ok(id);
[HttpPost] // POST: api/users
public IActionResult Create([FromBody] User user) => Created(“”, user);
}[controller] 自动替换为控制器名称（如 Users） [action] 可用于插入方法名，但一般 RESTful 接口不建议暴露动作名 每个方法可独立设置 HTTP 动词和路径参数
高级属性路由技巧
属性路由支持更复杂的路径结构和约束，提升接口可读性和安全性。
自定义路径：
[HttpGet(“search/{keyword:minlength(2)}”)]public IActionResult Search(string keyword)
这里加入了长度约束，确保 keyword 至少 2 个字符。
多路径支持：
[HttpGet(“all”)]
[HttpGet(“list”)]
public IActionResult GetAll()
同一个方法响应多个 URL。
版本化路由：
[Route(“api/v1/[controller]”)]
便于实现 API 版本控制。
基本上就这些。掌握传统路由和属性路由的配置方式，能让你更高效地构建结构清晰的 Web API。实际开发中建议优先使用属性路由，它更直观、可控性强，也更适合现代前后端分离架构。
以上就是.NET Web API如何配置路由（Routing）_路由配置方法详解的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1441945.html
微信扫一扫 
支付宝扫一扫 
