Swagger 3.0 ASP.NET Core - Как добавить документацию для схемы модели в тело запроса и ответ

Question

У меня есть схема модели для тела REST API и в ответ. Комментарии XML были определены, но я не могу найти способ включить документацию XML для схемы модели в Swagger UI 3.0 как в API body , так и в response ?

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);