c# - 有没有办法在 swagger-ui 页面中更改 Controller 的名称？

Question

我正在使用 Swashbuckle 在我的 WebApi 项目中启用 swagger 和 swagger-ui。

在下图中，您可以看到我的两个 Controller 显示在 swagger-ui 页面中。它们的命名与它们在 C# 代码中的名称相同，但我想知道是否有办法更改此处显示的内容？

这主要是因为如您所见，ManagementDashboardWidget 不是用户友好的名称，因此我想将其更改为用户友好的名称。

Answer 1

从 ASP.NET Core 6 开始，您可以使用 TagsAttribute在 Controller 级别:

[Tags("entity")]
[ApiController]
public class DerivedEntitiesController : ControllerBase
{

或在行动层面:

[Tags("entity")]
[HttpPut("entity/{key}")]
public IActionResult PutEntity(Guid key, [FromBody] Entity entity)
{

Swagger 将根据 Tags 进行分组并遵守 API 版本控制。