XML-литерал документа

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

Литерал, представляющий объект XDocument.

<?xml version="1.0" [encoding="encoding"] [standalone="standalone"] ?>
[ piCommentList ]
rootElement
[ piCommentList ]

Компоненты

• encoding
  Необязательный атрибут. Текст литерала для определения кодировки, используемой в документе.

• standalone
  Необязательный атрибут. Текст литерала. Необходимо значение "да" или "нет".

• piCommentList
  Необязательный атрибут. Список XML-инструкций по обработке и XML-комментариев. Принимает следующий формат:

  piComment [ piComment ... ]

  Каждый piComment может быть одним из следующих:

  • Литерал инструкции обработки XML.

  • XML-литерал комментария.

• rootElement
  Обязательный атрибут. Корневой элемент документа. Имеет один из следующих форматов:

  • Литеральное представление XML-элемента.

  • Встроенные выражения формы <%= elementExp %>. elementExp возвращает следующее:

    • Объект XElement.

    • Коллекция, содержащая один объект XElement и любое число объектов XProcessingInstruction и XComment.

  Дополнительные сведения см. в разделе Встроенные выражения в XML.

Возвращаемое значение

Объект XDocument.

Заметки

Литерал XML-документа определяется XML-объявлением в начале литерала. Каждый литерал XML-документа должен иметь ровно один корневой элемент XML и любое количество инструкций по обработке XML и XML-комментариев.

Литерал XML-документа не может появляться в элементе XML.

Примечание.
XML-литерал может занимать несколько строк без использования символа продолжения строки. Это позволяет скопировать содержимое из XML-документа и вставить его непосредственно в программу Visual Basic.

Компилятор Visual Basic преобразует литерал XML-документа в вызовы конструкторов XDocument и XDeclaration.

Пример

В следующем примере создается XML-документ, который содержит XML объявление, инструкции по обработке, комментарий и элемент, содержащий другие элементы.

Dim libraryRequest As XDocument = _
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <?xml-stylesheet type="text/xsl" href="show_book.xsl"?>
    <!-- Tests that the application works. -->
    <books>
        <book/>
    </books>
Console.WriteLine(libraryRequest)

См. также

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

Встроенные выражения в XML

Ссылки

Литерал инструкции обработки XML

XML-литерал комментария

Литеральное представление XML-элемента

XElement

XProcessingInstruction

XComment

XDocument

Другие ресурсы

XML-литералы

Создание XML в Visual Basic