ASP.NET Core 创建 Web API 推荐新手从 Minimal API 入手,用 dotnet new web -n MyApi 创建轻量项目,几行代码即可定义路由与处理逻辑;中大型项目则宜采用 Controller 模式,通过特性标注实现规范分层与功能扩展。

ASP.NET Core 创建 Web API 很简单,核心是用 Minimal API 或 Controller 模式 两种主流方式,推荐新手从 Minimal API 入手,代码少、逻辑直、上手快。
用 dotnet CLI 快速创建项目
打开终端,执行一行命令即可生成一个纯净的 API 项目:
dotnet new webapi -n MyApi(带 Controller 的传统方式) dotnet new web -n MyApi(Minimal API 轻量模板,更现代)
进入项目目录后运行 dotnet run,API 就在 https://localhost:5001 启动了。
Minimal API:几行代码写个接口
在 Program.cs 里直接添加路由和处理逻辑,比如返回 JSON 数据:
添加 GET 接口:app.MapGet(“/hello”, () => new { Message = “Hello from ASP.NET Core!” }); 支持参数:app.MapGet(“/users/{id}”, (int id) => new { Id = id, Name = $”User{id}” }); 返回状态码:app.MapPost(“/users”, (User user) => Results.Created($”/users/{user.Id}”, user));
不需要控制器类、不用配置路由属性,依赖注入和模型绑定自动可用。
Controller 方式:适合中大型项目
如果项目需要分层、复用、版本控制或 Swagger 文档,用 Controller 更规范:
新建 Controllers/WeatherForecastController.cs 继承 ControllerBase,加上 [ApiController] 特性 用 [HttpGet]、[HttpPost] 等特性定义路由和方法 返回 IActionResult 或具体类型(如 List),框架自动序列化为 JSON
默认已启用模型验证、绑定、格式化,开箱即用。
别忘了基础配置
无论哪种方式,这几个点容易忽略但很关键:
确保 Program.cs 中调用了 builder.Services.AddControllers()(Controller 方式)或没禁用默认 JSON 支持 开发环境建议启用 Swagger:app.UseSwagger(); app.UseSwaggerUI(); 跨域(CORS)若需前端调用,加 builder.Services.AddCors() 和中间件 JSON 序列化设置(如忽略 null 值、驼峰命名)可在 AddJsonOptions 中调整
基本上就这些,不复杂但容易忽略细节。跑通第一个 GET /hello 后,再逐步加 POST、数据库、认证,节奏就很稳了。
以上就是ASP.NET Core怎么创建API ASP.NET Core Web API入门方法的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1442894.html
微信扫一扫
支付宝扫一扫