Swager 3.0 ASP。NET核心-如何在请求正文和响应中添加模型架构文档

Question

我有REST API主体和响应的模型模式。XML注释已经定义好了，但是我想不出一种方法在API主体和响应中包含Swagger UI 3.0中模型模式的XML文档。

Answer 1

我错过了这个，它现在可以工作了。我让架构分布在不同的 asp.net 核心程序集上，Swagger UI 3.0 确实支持添加多个 XML 源。

要包含控制器注释本身，我们必须设置包括控制器注释：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);