NSwag:如何在ASP.Net核心Web API中添加路由参数说明

NSwag是一个用于生成OpenAPI/Swagger规范的工具，可以帮助开发人员在ASP.Net Core Web API中添加路由参数说明。下面是如何在ASP.Net Core Web API中使用NSwag添加路由参数说明的步骤：

首先，确保你的项目中已经安装了NSwag.AspNetCore包。可以通过NuGet包管理器或者在.csproj文件中手动添加引用来安装该包。
打开Startup.cs文件，在ConfigureServices方法中添加以下代码来配置NSwag：

services.AddSwaggerDocument(config =>
{
    config.PostProcess = document =>
    {
        document.Info.Title = "Your API Title";
        document.Info.Description = "Your API Description";
    };
});

这段代码将添加一个Swagger文档，并设置API的标题和描述。

在Configure方法中添加以下代码来启用Swagger UI：

app.UseOpenApi();
app.UseSwaggerUi3();

这将在应用程序的URL路径中添加Swagger UI，用于查看和测试API。

在需要添加路由参数说明的控制器的操作方法上，使用NSwag的特性来添加参数说明。例如，如果你的控制器是名为"SampleController"，操作方法是"Get"，并且有一个名为"id"的路由参数，可以使用以下代码添加参数说明：

[HttpGet("{id}")]
[OpenApiOperation("GetById")]
[OpenApiParameter("id", Description = "The ID of the item")]
public IActionResult Get(int id)
{
    // Your code here
}

这段代码使用了NSwag的特性OpenApiOperation和OpenApiParameter来添加参数说明。