Я унаследовал кучу кода С#. Для нескольких определений методов я нахожу ///<exclude/> как единственный XMLDoc перед ним. Я попытался понять смысл Google, но не был успешным. Может кто-нибудь объяснить, что это может означать?
Что означает "///<исключить/" >"?
Ответ 1
В NDoc, это означает, что XML-документация для этого члена должна быть исключена. В документации :
Тег
<exclude/>направляет NDoc для исключения текущего документа из документации.
Мне не ясно, было ли это изначально специфичным для NDoc, но, похоже, также поддерживается Sandcastle (в этом в руководстве по комментариям Sandcastle XML).
Ответ 2
Из Файл с файлами Builder, :
Пространство имен исключается через свойство "Суммарное пространство имен" или элемент исключен, поскольку его комментарии XML включают < exclude/ > тег. Эта информация автоматически объединяется с фильтром API Настройки. Чтобы изменить эти элементы, вам необходимо использовать пространство имен Свойство Summaries или удалить тег из комментариев XML-элемента.
Официальный ответ:
Способ исключения документации?
И больше информации о поведении: