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-литерал комментария в вызов конструктора #ctor.
Пример
В следующем примере создается XML-комментарий, содержащий текст "This is a comment".
Dim com As XComment = <!-- This is a comment -->
См. также
Ссылки
Литеральное представление XML-элемента (Visual Basic)