Поделиться через


Рекомендуемые XML-теги для комментариев документации (Visual Basic)

Компилятор Visual Basic может обрабатывать комментарии документации в коде в XML-файле. Дополнительные средства можно использовать для обработки XML-файла в документацию.

Примечания XML допускаются для конструкций кода, таких как типы и члены типов. Для частичных типов только одна часть типа может иметь XML-комментарии, хотя нет ограничений на комментарии его членов.

Замечание

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

Компилятор обрабатывает любой тег, который является допустимым XML. Следующие теги предоставляют часто используемые функции в пользовательской документации.

(1 Компилятор проверяет синтаксис.)

Замечание

Если вы хотите, чтобы угловые скобки отображались в тексте комментария документации, используйте &lt; и &gt;. Например, строка "&lt;text in angle brackets&gt;" будет отображаться как <text in angle brackets>.

См. также