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")] 。