c# - 是否可以让 NSwag 忽略控制器？

Question

我使用 NSwag 为单个控制器生成客户端；我需要它作为自己独立的客户。我希望在将来生成 Swagger 规范时忽略它。

我尝试在控制器顶部添加此属性，但在规范中仍然注明： [ApiExplorerSettings(IgnoreApi = true)]

我的控制器正在实现标准Microsoft.AspNetCore.Mvc.Controller类。

Answer 1

我认为在最新版本中，

[ApiExplorerSettings(IgnoreApi = true)]

支持。

否则，您可以添加SwaggerIgnoreAttributeOROpenApiIgnoreAttribute属性

[SwaggerIgnore]
[OpenApiIgnore]

或者在 NSwagStudio 或中间件中手动选择控制器...

Answer 2

利用 [OpenApiIgnore]

（因为[SwaggerIgnore]已被弃用）

Answer 3

@Arieh 的回答对我有用。我想分享更多。

1. 为 DTO 类安装包NSwag.Annotations，对于我在单独项目中的情况，然后使用[OpenApiIgnore]装饰应该忽略的属性。
2. 为 Web 项目安装包NSwag.AspNetCore。