使用ActionName属性似乎打破了Swagger文档（Web API，Swashbuckle）

Question

我正在尝试使用Swagger＆amp ;;的XML评论为我的Web API项目生成API文档。 Swashbuckle。似乎在动作上使用ActionName属性会破坏行中的某些内容。该操作包含在生成的XML中，并显示在Swagger UI中，但是当我单击它时没有详细信息（摘要，参数等）。我不确定这是.NET，Swagger还是Swashbuckle问题。

我尝试使用和不使用ActionName属性，它似乎对生成的XML没有影响。但是，该属性会更改Swagger中显示的名称。这让我相信它可能与Swagger / Swashbuckle有关......也许是ApiExplorer？

Answer 1

我已经确定这是Swashbuckle中的一个错误。 .NET使用实际方法名称生成XML文档，而不是ActionName属性中指定的名称。因此，它需要在Swashbuckle代码中处理。我在GitHub中输入了一个问题，包括一个解决方法，直到它被修复 - https://github.com/domaindrivendev/Swashbuckle/issues/118。