XML-литерал документа (Visual Basic)

  • Статья

Литерал, 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 одно из следующих элементов:


Дополнительные сведения см. в разделе "Внедренные выражения" в ФОРМАТЕ 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)

См. также