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


Практическое руководство. Создание XML-документации в Visual Basic

Обновлен: Ноябрь 2007

В этом примере демонстрируется добавление комментариев XML-документации в код.

Создание XML-документации для типа или члена

  1. В редакторе кода поместите курсор на одну строку выше типа или члена, для которого требуется создать документацию.

  2. Введите ''' (три знака одинарных кавычек).

    Схема XML для типа или члена добавляется в редактор кода.

  3. Добавьте описательные сведения между соответствующими тегами.

    xzysab5k.alert_note(ru-ru,VS.90).gifПримечание.

    Чтобы добавить дополнительные строки внутри блока XML-документации, следует начинать каждую строку с кавычек '''.

  4. Добавьте дополнительный код, который использует тип или член с новыми комментариями XML-документации.

    IntelliSense отображает текст из тега <summary> для типа или члена.

  5. Скомпилируйте код для создания XML-файла, содержащего комментарии документации. Дополнительные сведения см. в разделе /doc.

См. также

Основные понятия

Документирование кода с помощью XML (Visual Basic)

Ссылки

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

/doc