C# 创建RESTful API教程详解
使用ASP.NETCore创建RESTfulAPI：安装.NETSDK后，通过dotnetnewwebapi命令创建项目，定义Product模型和ProductsController实现CRUD操作，运行dotnetrun启动服务，访问https://localhost:5001/swagger测试接口，可选集成EntityFrameworkCore支持数据库，并通过dotnetpublish部署应用。
使用ASP.NET Core创建RESTful API：安装.NET SDK后，通过dotnet new webapi命令创建项目，定义Product模型和ProductsController实现CRUD操作，运行dotnet run启动服务，访问https://localhost:5001/swagger测试接口，可选集成Entity Framework Core支持数据库，并通过dotnet publish部署应用。
要使用 C# 创建一个 RESTful API，最常用的方式是通过 ASP.NET Core。它轻量、跨平台，并且非常适合构建现代 Web API。下面是一个完整的入门教程，带你从零开始创建一个简单的 RESTful API。
1. 准备开发环境
确保你已安装以下工具：
- .NET SDK（建议 6.0 或更高版本）
- Visual Studio（2022 推荐）或 Visual Studio Code
- 终端/命令行工具
你可以通过运行 dotnet --version 检查是否已安装 .NET SDK。
2. 创建 Web API 项目
打开终端，执行以下命令创建一个新的 Web API 项目：
dotnet new webapi -n MyRestApicd MyRestApi
dotnet run
项目创建完成后，默认会在 http://localhost:5000 启动服务，访问 https://localhost:5001/weatherforecast 可看到示例数据。
3. 理解项目结构
关键文件和目录说明：
- Program.cs：应用入口，配置服务和中间件（.NET 6+ 使用隐式 using 和顶级语句）
- Controllers 文件夹：存放控制器类，处理 HTTP 请求
- appsettings.json：配置文件，如数据库连接字符串
- Properties/launchSettings.json：本地运行配置
4. 创建自己的数据模型
添加一个表示“产品”的类：
public class Product{
public int Id { get; set; }
public string Name { get; set; } = string.Empty;
public decimal Price { get; set; }
}
将这个类保存在项目根目录下，命名为 Product.cs。
5. 创建控制器处理请求
新建控制器 ProductsController.cs：
using Microsoft.AspNetCore.Mvc;[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
private static List
{
new Product { Id = 1, Name = "键盘", Price = 299 },
new Product { Id = 2, Name = "鼠标", Price = 99 }
};
[HttpGet]
public IActionResult Get() => Ok(_products);
[HttpGet("{id}")]
public IActionResult Get(int id)
{
var product = _products.FirstOrDefault(p => p.Id == id);
return product == null ? NotFound() : Ok(product);
}
[HttpPost]
public IActionResult Post(Product product)
{
product.Id = _products.Max(p => p.Id) + 1;
_products.Add(product);
return CreatedAtAction(nameof(Get), new { id = product.Id }, product);
}
[HttpPut("{id}")]
public IActionResult Put(int id, Product updatedProduct)
{
var product = _products.FirstOrDefault(p => p.Id == id);
if (product == null) return NotFound();
product.Name = updatedProduct.Name;
product.Price = updatedProduct.Price;
return NoContent();
}
[HttpDelete("{id}")]
public IActionResult Delete(int id)
{
var product = _products.FirstOrDefault(p => p.Id == id);
if (product == null) return NotFound();
_products.Remove(product);
return NoContent();
}
}
这个控制器实现了标准的 CRUD 操作：
- GET /api/products → 获取所有产品
- GET /api/products/1 → 获取特定产品
- POST /api/products → 添加新产品
- PUT /api/products/1 → 更新产品
- DELETE /api/products/1 → 删除产品
6. 测试你的 API
启动服务：
dotnet run使用工具测试 API：
- 浏览器访问 https://localhost:5001/api/products
- 使用 Postman 或 curl 发送 POST、PUT、DELETE 请求
- VS Code 安装 Thunder Client 插件进行测试
7. 添加数据库支持（可选）
若需要持久化存储，可集成 Entity Framework Core：
dotnet add package Microsoft.EntityFrameworkCore.SqlServerdotnet add package Microsoft.EntityFrameworkCore.Tools
然后定义 DbContext：
public class AppDbContext : DbContext{
public DbSet
protected override void OnConfiguring(DbContextOptionsBuilder options)
=> options.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=MyAppDb;Trusted_Connection=true;");
}
再在 Program.cs 中注册上下文：
builder.Services.AddDbContext8. 启用 Swagger 文档
ASP.NET Core 模板默认已集成 Swagger（也叫 OpenAPI）。运行项目后访问：
https://localhost:5001/swagger你可以在浏览器中查看和测试所有 API 接口。
9. 部署 API
发布项目到生产环境：
dotnet publish -c Release -o ./publish然后将 publish 文件夹部署到 IIS、Docker、Azure 或 Linux 服务器上。
基本上就这些。你现在拥有了一个功能完整的 C# RESTful API，支持标准 HTTP 方法、JSON 数据交换，并具备扩展能力。后续可以加入身份验证（JWT）、日志记录、异常处理、CORS 配置等高级功能。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
