Разве теги документации XML не обрабатываются страницами справки Web API 2?

Я пытаюсь использовать <see cref=""> теги в моей документации XML теги для моего API, но они не отображаются на страницах справки.

Итак, для описания я хотел бы сказать:

Msgstr "Получает или задает значение для связанного элемента."

Где Item - это ссылка на другой объект в API.

Вместо этого я получаю:

Msgstr "Получает или задает значение для связанного."

Итак <see cref=""> тег игнорируется. Я даже пытался использовать примеры здесь на случай, если мое объявление было неверным, но это тоже не сработало.

У кого-нибудь еще были проблемы с этим? На каком уровне поддерживаются теги XML-документации на новых страницах справки Web API 2? Кто-нибудь знает, возможно ли добавить поддержку для этого вручную, если нет?

Источник

1 ответ

У меня не было проблем с этим, но я предлагаю вам

  • Опубликуйте простой пример, который иллюстрирует поведение вместе с полученным результатом.

  • Проверьте наличие предупреждений о сборке, которые могут указывать на проблемы с тегами документации XML.

Например, вы говорите, что используете <see cref=""> Вы вводите действительный идентификатор в атрибут cref и закрываете тег see - например, <see cref="MyClass.MyMethod" />?

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