本教程详细介绍使用Visual Studio 2019和.NET Core开发WeiApi的过程，涵盖环境搭建、项目创建及核心功能实现等步骤。
使用Visual Studio 2019 (VS2019) 和 .NET Core 创建Web API的过程将在此进行详细探讨，特别针对“WeiApi”的创建过程。
步骤一：创建新项目
启动 VS2019 并选择“新建项目”。在模板中找到并选择“.NET Core”下的“ASP.NET Core Web 应用程序”。
步骤二：选择项目类型
接下来的对话框会要求你为项目选择一个模板，这里我们选“API”，这将创建一个预配置为Web API项目的环境。
步骤三：定义项目设置
输入新项目的名称（例如“WeiApi”）以及存储位置，并点击“创建”。
步骤四：删除默认类文件
在项目生成后，你会看到一些默认的文件和类。为了自定义我们的API，我们可以移除不需要的控制器，比如“ValuesController”。
步骤五：添加新的控制器
右键单击项目的“Controllers” 文件夹并选择 “添加 -> 控制器”，创建一个新的 API 控制器，并命名为 `CalculationController`。
步骤六：设置路由
在新生成的 `CalculationController` 类中定义路由模式。例如：
```csharp
[Route(api/[controller]/[action])]
public class CalculationController : ControllerBase
```
这将告诉API，所有该控制器中的方法都将遵循“api/Calculation/{action}” 的格式。
步骤七：编写接口方法
在 `CalculationController` 中定义不同的HTTP操作。下面是一些示例：
```csharp
[HttpGet]
public ActionResult Get()
{
return Hello World!;
}
[HttpGet]
public ActionResult Sum(int num1, int num2)
{
return num1 + num2;
}
[HttpPost]
public ActionResult Subtract([FromBody] Param param)
{
int result = param.num1 - param.num2;
return result;
}
```
其中，`Param`类用于承载POST请求的参数：
```csharp
public class Param
{
public int num1 { get; set; }
public int num2 { get; set; }
}
```
步骤八：调试与测试
使用VS2019内置工具运行API，并通过浏览器或Postman等工具进行调用和测试。例如，访问“http://localhost:port/api/Calculation/get” 来测试 “Get” 方法。
步骤九：集成Swagger
为了便于管理和调试，可以引入 Swagger。首先安装 `Swashbuckle.AspNetCore` 包，然后在 `Startup.cs` 文件中的 `ConfigureServices` 和 `Configure` 方法中添加相应的配置代码：
```csharp
services.AddSwaggerGen(c =>
{
c.SwaggerDoc(v1, new OpenApiInfo { Title = 接口文档, Version = v1 });
添加XML注释路径
var xmlFile = Assembly.GetExecutingAssembly().GetName().Name + .xml;
var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
c.IncludeXmlComments(xmlPath);
});
app.UseSwagger();
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint(/swagger/v1/swagger.json, 接口文档 v1);
});
```
当应用运行时，可以通过“http://localhost:port/swagger” 访问 Swagger UI。
总结：
通过以上步骤，我们已经成功使用VS2019和.NET Core创建了一个简单的Web API。这包括定义路由、实现HTTP操作方法以及集成Swagger进行API管理。这只是一个基础的起点，在实际开发中可能还需要处理更复杂的业务逻辑、身份验证、错误处理等等方面的问题。
5星
