NSwag 更改控制器说明

Question

我想在 .Net Core 中更改 NSwag UI 的控制器描述。我正在使用最新版本 (13.8.1)。如何实现？

根据上图，我想将标题 RefUserLocation 重命名为 User Location。但不会更改用户仍然能够访问 api/refuserlocation

的端点本身

Answer 1

将 [OpenApiTag("RenameName")] 添加到您的控制器，如下所示：

using NSwag.Annotations;

[Route("api/[controller]")]
[ApiController]
[OpenApiTag("User Location")]
public class RefUserLocationController : ControllerBase
{...}

结果：

注：

我用的是NSwag.AspNetCore version 13.8.2。所以SwaggerTag已经过时了，如果你用的是旧版本的nswag，你可以用[SwaggerTag("User Location")]。