Как файлы комментариев Swagger XML включены в ASP.NET Основной сервер?

#asp.net-core #swagger

#asp.net-core #swagger

Вопрос:

Я использую Swashbuckle для документации API, которая требует projectname.xml документ из выходных данных, но когда я создаю свой ASP.NET Основной проект Я не получаю этот файл.

https://learn.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger

Что я должен делать при публикации на сервере?

 var xmlFile = "${System.Reflection.Assembly.GetExecutingAssembly().GetName().Name}.xml";
c.IncludeXmlComments(System.IO.Path.Combine(AppContext.BaseDirectory, xmlFile));
  

Комментарии:

1. Вы следовали инструкциям в документах ?

Ответ №1:

Для того, чтобы генерировать XML-документацию из комментариев к коду. Вы захотите открыть свойства проекта во всех своих проектах, перейти на вкладку «Сборка» и проверить файл документации XML. Это гарантирует, что XML-документ будет сгенерирован в указанном расположении. Вы захотите использовать относительный путь для выходного каталога.