Самодокументируемый asp.net api

Я создал API Asp.net в VS2015. Внутри Области>HelpPage>App_Start>HelpPageConfig.cs Я раскомментировал строку 37

config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/XmlDocument.xml")));

В папке App_Data для проекта не было файла XmlDocument.xml, поэтому я создал файл с тегами, которые я видел в самодокументирующихся файлах XML в других API-интерфейсах.

<?xml version="1.0" encoding="utf-8" ?>
<doc>
  <assembly>
    <name>NameOfApiHere</name>
  </assembly>
  <members>
  </members>
</doc>

но при сборке и / или запуске приложения ничего не входит в XML. Насколько я понимаю, когда этот параметр включен для документов XML sel, основанных на каждой /// сводке для данного метода, с предупреждением о целочисленности для любого общедоступного метода, у которого нет сводки, но я не могу найти никакого кода, который бы явно копировал Сводная информация для этого xml в виде тегов "member" внутри тега "members" также не происходит. Какой шаг мне не хватает, что я не вижу в том, как в Интернете, чтобы включить самостоятельную документацию в APi?

Источник

2 ответа

Решение

В свойствах проекта переместите папку с документацией XML в нужную папку. Я полагаю, было бы лучше использовать app_data вместо App_code папка.

взгляните на 1 и 2 этапы ответа на этот вопрос

Источник

Попробуйте удалить XmlDocument.xml файл, который вы добавили (я думаю, что он автоматически генерируется) и укажите путь к нему в настройках проекта -> вкладка "Сборка" в разделе " Вывод"

Источник
Другие вопросы по тегам