Использование атрибута ActionName, похоже, нарушает документацию Swagger (веб-API, Swashbuckle)

Question

Я пытаюсь создать документацию API для моего проекта веб-API с помощью комментариев XML через Swagger & Swashbuckle. Похоже, что использование атрибута ActionName в действии ломает что-то где-то вдоль линии. Действие включено в сгенерированный XML, и оно отображается в пользовательском интерфейсе Swagger, но при нажатии на него нет данных (сводка, параметр и т. Д.). Я не уверен, что это проблема .NET, Swagger или Swashbuckle.

Я пробовал с атрибутом ActionName и без него, и, похоже, он не влияет на генерируемый XML. Однако атрибут изменяет имя, отображаемое в Swagger. Это заставляет меня поверить, что это может иметь какое-то отношение к Swagger/Swashbuckle ... возможно, ApiExplorer?

Answer 1

Я определил, что это ошибка в Swashbuckle. .NET генерирует XML-документацию с именем фактического метода, а не с именем, указанным в атрибуте ActionName. Поэтому его нужно обрабатывать в коде Swashbuckle. Я ввел вопрос в GitHub, в том числе обходной путь до его исправления - https://github.com/domaindrivendev/Swashbuckle/issues/118.