Swagger 3.0 ASP.NET Core-如何在请求正文和响应中添加模型架构的文档

Question

我拥有REST API主体的模型架构，并对此做出了回应。 XML注释已经定义，但是我无法找到一种方法来在API body和response？

中将Swagger UI 3.0的模型架构包含XML文档。

Answer 1

我错过了，现在可以了。我将架构分布在不同的asp.net核心程序集中，并且Swagger UI 3.0确实支持添加多个XML源。

要包括控制器注释本身，我们必须设置includeControllerXmlComments：true

c.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, "test1.xml"), includeControllerXmlComments: true);
c.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, "test2.xml"), includeControllerXmlComments: true);
c.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, "test3.xml"), includeControllerXmlComments: true);