XML 文件常值

更新：2007 年 11 月

常值 (Literal)，表示 XDocument 物件。

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

參數

• encoding
  選擇項，常值文字，宣告文件要使用哪種編碼。

• standalone
  選擇項，常值文字，必須是 "yes" 或 "no"。

• 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 常值 (Literal) 可以在不需使用行接續字元的情況下跨越數行。這可讓您複製 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 常值

在 Visual Basic 中建立 XML