XML-литерал комментариев (Visual Basic)
Литерал, XComment представляющий объект.
Синтаксис
<!-- content -->
Детали
Термин | Определение |
---|---|
<!-- |
Обязательный. Обозначает начало XML-комментария. |
content |
Обязательный. Текст, отображаемый в xml-комментарии. Не удается содержать ряд двух дефисов (-) или заканчиваться дефисом рядом с закрывающим тегом. |
--> |
Обязательный. Обозначает конец XML-комментария. |
Возвращаемое значение
Объект XComment.
Замечания
Литералы комментариев XML не содержат содержимого документа; они содержат сведения о документе. Раздел комментариев XML заканчивается последовательностью "-->". Это означает следующие моменты:
Нельзя использовать внедренное выражение в литерале комментариев XML, так как внедренные разделители выражений являются допустимым содержимым XML-комментариев.
Разделы комментариев XML не могут быть вложены, так как
content
не может содержать значение "-->".
Можно назначить литерал комментариев XML переменной или включить его в литерал XML-элемента.
Примечание.
Xml-литерал может охватывать несколько строк без использования символов продолжения строки. Эта функция позволяет скопировать содержимое из XML-документа и вставить его непосредственно в программу Visual Basic.
Компилятор Visual Basic преобразует литерал комментариев XML в вызов конструктора XComment .
Пример
В следующем примере создается xml-комментарий, содержащий текст "Это комментарий".
Dim com As XComment = <!-- This is a comment -->