ASP.NET Core怎么创建Web API ASP.NET Core创建RESTful API步骤

ASP.NET Core 创建 Web API 的核心是 Controller + [ApiController] + 模型绑定 + 内置 JSON 序列化;需新建项目、添加带特性的控制器、可选配置 JSON 和 CORS。

asp.net core怎么创建web api asp.net core创建restful api步骤

ASP.NET Core 创建 Web API 很简单,核心是用 Controller + [ApiController] 特性 + 模型绑定 + 内置 JSON 序列化,不需要额外装包(.NET 6+ 默认内置)。

1. 新建 ASP.NET Core Web API 项目

用 CLI 或 Visual Studio 都行,推荐命令行快速启动:

dotnet new webapi -n MyApi —— 创建带 WeatherForecast 示例的模板 cd MyApi && dotnet run —— 启动后访问 https://localhost:5001/weatherforecast 就能看到默认 API

注意:.NET 6+ 模板默认启用 minimal hosting 模式(Program.cs 里一行 builder.Build()),但 Controller 方式仍完全支持,无需改写。

2. 添加自己的 API Controller

右键项目 → 添加 → 新建控制器 → 选择 “API Controller with actions, using Entity Framework”(如果连数据库)或 “API Controller – Empty”(纯接口)。

给类加上 [ApiController][Route("api/[controller]")] 方法用 HTTP 方法特性标记,比如 [HttpGet][HttpPost] 返回类型建议用 IActionResult 或具体模型(如 Task>),框架会自动序列化为 JSON

示例:

[ApiController][Route("api/[controller]")]public class ProductsController : ControllerBase{    [HttpGet]    public IActionResult Get() => Ok(new[] { new { Id = 1, Name = "Laptop" } });    [HttpPost]    public IActionResult Create([FromBody] Product product)    {        // 处理逻辑        return CreatedAtAction(nameof(Get), new { id = 1 }, product);    }}

3. 启用并配置 JSON 序列化(可选但常用)

.NET 6+ 默认用 System.Text.Json,若需兼容旧习惯(如驼峰命名、忽略 null 值),在 Program.cs 中配置:

builder.Services.AddControllers().AddJsonOptions(opt => { opt.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase; }); 如需支持循环引用或 DateTime 格式控制,也可在这里设 ReferenceHandlerConverters

4. 启用 CORS(跨域调试时必需)

前端调用本地 API 时浏览器会拦截,加一段配置即可:

Program.cs 中添加服务:builder.Services.AddCors(); 在中间件中启用:app.UseCors(policy => policy.AllowAnyOrigin().AllowAnyMethod().AllowAnyHeader()); 生产环境请替换 AllowAnyOrigin() 为具体域名

基本上就这些。不复杂但容易忽略路由匹配、模型绑定失败静默返回 400、以及没开 CORS 导致前端收不到响应——检查这几个点,API 就能稳稳跑起来。

以上就是ASP.NET Core怎么创建Web API ASP.NET Core创建RESTful API步骤的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1443264.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月17日 19:54:29
下一篇 2025年12月17日 19:54:42

相关推荐

发表回复

登录后才能评论
关注微信