使用VS2022在ASP.NET Core中构建轻量级服务

下面是使用VS2022在ASP.NET Core中构建轻量级服务的完整攻略：

简介

ASP.NET Core是一个跨平台的开源框架，它提供了构建 Web 应用程序和服务的工具和框架。本攻略将带你使用VS2022在ASP.NET Core中构建轻量级服务。

步骤一：创建 ASP.NET Core 项目

1. 打开 Visual Studio 2022，选择“创建新项目”；
2. 在“新建项目”对话框中，选择“ASP.NET Core Web 应用程序”；
3. 在下一个页面中，选择“API”，然后单击“下一步”；
4. 输入项目名称，选择项目位置，然后单击“创建”按钮。

步骤二：添加控制器

1. 在“解决方案资源管理器”中，右键单击“Controllers”文件夹，选择“添加” > “新建项”；
2. 在“添加新项”对话框中，选择“控制器类”，并输入控制器名称；
3. 选择“Web API”控制器模板，并单击“添加”按钮。

步骤三：编写控制器代码

在“Controllers”文件夹中的控制器类文件中，编写以下示例代码，以返回一个字符串：

[ApiController]
[Route("[controller]")]
public class SampleController : ControllerBase
{
    [HttpGet]
    public string Get()
    {
        return "Hello, World!";
    }
}

步骤四：启动应用程序

1. 单击“调试”按钮，在“应用程序管理器”中选择本地 IIS Express；
2. 应用程序将启动，并将显示默认的欢迎页面；
3. 在地址栏中输入 https://localhost:XXXXX/Sample，并按 Enter 键。此处 XXXXX 是 IIS Express 所使用的端口号；
4. 可以看到浏览器返回了“Hello, World!”信息。

步骤五：测试 API

1. 打开 Postman 工具；
2. 在“新建请求”对话框中，输入以下请求 URL：https://localhost:XXXXX/Sample；
3. 选择 HTTP 方法“GET”；
4. 单击“发送”按钮；
5. 可以看到 Postman 返回了“Hello, World!”信息。

至此，您已经完成了使用VS2022在ASP.NET Core中构建轻量级服务的整个过程！

示例说明：

以下是两个简单的示例，以说明如何在 ASP.NET Core 中构建轻量级服务：

示例一：返回 Json 数据

控制器类：

[ApiController]
public class SampleController : ControllerBase
{
    [HttpGet]
    [Route("api/users")]
    public IActionResult GetUsers()
    {
        List<User> users = new List<User>
        {
            new User { Id = 1, Name = "张三" },
            new User { Id = 2,  Name = "李四" },
        };

        return Ok(users);
    }
}

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
}

此时，请求 URL 是 https://localhost:XXXXX/api/users。

示例二：使用 Swagger 接口文档

ASP.NET Core 中提供了一个名为 Swagger 的工具包，可以自动生成 API 接口文档，方便前端调用。

1. 在代码文件中添加 Swagger 文档生成器：

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
});

1. 构建 swagger 终端配置：

app.UseSwagger();
app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
    c.RoutePrefix = string.Empty;
});

1. 启动应用程序，并使用浏览器访问 http://localhost:/swagger/index.html。

至此，您就可以使用 Swagger 工具包轻松地生成 API 接口文档了。

希望这个答案对您有所帮助！