XML 物件

Flash Player 9 以及更新的版本，Adobe AIR 1.0 以及更新的版本

XML 物件可以代表 XML 元素、特質、註解、處理指示，或文字元素。

XML 物件可以分類為具有「簡單內容」或「複雜內容」。具有子節點的 XML 物件是分類為具有複雜內容；而當 XML 物件為下列任一項目時，這個物件即具有簡單內容：特質、註解、處理指示或文字節點。

例如，下列 XML 物件包含複雜內容，其中包括了註解和處理指示： 

XML.ignoreComments = false; 
XML.ignoreProcessingInstructions = false; 
var x1:XML =  
    <order> 
        <!--This is a comment. --> 
        <?PROC_INSTR sample ?> 
        <item id='1'> 
            <menuName>burger</menuName> 
            <price>3.95</price> 
        </item> 
        <item id='2'> 
            <menuName>fries</menuName> 
            <price>1.45</price> 
        </item> 
    </order>

如下列範例所示，您現在可以使用 comments() 和 processingInstructions() 方法來建立新的 XML 物件、註解與處理指示： 

var x2:XML = x1.comments()[0]; 
var x3:XML = x1.processingInstructions()[0];

XML 屬性

XML 類別具有五個靜態屬性：

  • 剖析 XML 物件時， ignoreComments 和 ignoreProcessingInstructions 屬性會判斷是否忽略註解和處理指示。

  • ignoreWhitespace 屬性會判斷是否要在元素標籤與內嵌運算式 (只依據空白字元來分隔) 中忽略空白字元。

  • prettyIndent 和 prettyPrinting 屬性是用來格式化 XML 類別的 toString() 和 toXMLString() 方法所傳回的文字。

如需這些屬性的詳細資訊，請參閱 適用於 Adobe Flash Platform 的 ActionScript 3.0 參考 。

XML 方法

下列方法可讓您使用 XML 物件的階層架構：

  • appendChild()

  • child()

  • childIndex()

  • children()

  • descendants()

  • elements()

  • insertChildAfter()

  • insertChildBefore()

  • parent()

  • prependChild()

下列方法可讓您使用 XML 物件特質：

  • attribute()

  • attributes()

下列方法可讓您使用 XML 物件屬性：

  • hasOwnProperty()

  • propertyIsEnumerable()

  • replace()

  • setChildren()

下列方法可讓您處理限定名稱與命名空間：

  • addNamespace()

  • inScopeNamespaces()

  • localName()

  • name()

  • namespace()

  • namespaceDeclarations()

  • removeNamespace()

  • setLocalName()

  • setName()

  • setNamespace()

下列方法可讓您使用並判斷特定類型的 XML 內容：

  • comments()

  • hasComplexContent()

  • hasSimpleContent()

  • nodeKind()

  • processingInstructions()

  • text()

下列方法可供用來轉換成字串以及格式化 XML 物件：

  • defaultSettings()

  • setSettings()

  • settings()

  • normalize()

  • toString()

  • toXMLString()

此外，還有幾個額外的方法：

  • contains()

  • copy()

  • valueOf()

  • length()

如需這些方法的詳細資訊，請參閱 適用於 Adobe Flash Platform 的 ActionScript 3.0 參考 。