交换XML注释文件-缺少注释

Question

我正在使用Swashbuckle.Core 5.6.0 为我的Web API 2 API自托管Swagger文档

我在Startup.cs中启用Swagger，如下所示

config.EnableSwagger(c => 
{
c.SingleApiVersion("v1", "AUDM API");
c.IncludeXmlComments(AppDomain.CurrentDomain.BaseDirectory + "commentsfile1.xml");
c.IncludeXmlComments(AppDomain.CurrentDomain.BaseDirectory + "commentsfile2.xml");
c.DescribeAllEnumsAsStrings();
}).EnableSwaggerUi(/*x => x.DisableValidator()*/);

招摇过市的ui显示得很好，列出了我所有的端点和方法。但是，没有任何文档。。我在控制器上的所有评论和备注都不见了，也不见了

当我调试并查看XML文件的两个完全限定路径时，它们在运行时解析得很好，所以我认为这应该很好。

这两个xml文件来自不同的库，但这不重要，应该吗…文件在那里，所以IMHO应该使用它们。有没有办法解决XML文件没有被拾取的原因？

Answer 1

我认为路径中可能缺少斜杠，请尝试以下操作：

c.IncludeXmlComments(AppDomain.CurrentDomain.BaseDirectory + "commentsfile1.xml");

以下是官方项目的样本：https://github.com/domaindrivendev/Swashbuckle/blob/5489aca0d2dd7946f5569341f621f581720d4634/Swashbuckle.Dummy.Core/App_Start/SwaggerConfig.cs#L261