XML-Objekte

Flash Player 9 und höher, Adobe AIR 1.0 und höher

XML-Objekte können XML-Elemente, Attribute, Kommentare, Verarbeitungsanweisungen oder Textelemente darstellen.

XML-Objekte werden als Objekte mit einfachem Inhalt oder mit komplexem Inhalt klassifiziert. XML-Objekte mit untergeordneten Knoten werden als Objekte mit komplexem Inhalt klassifiziert. Es wird von XML-Objekten mit einfachem Inhalt gesprochen, wenn es sich um eines der folgenden Objekte handelt: ein Attribut, einen Kommentar, eine Verarbeitungsanweisung oder einen Textknoten.

Bei dem folgenden XML-Objekt handelt es sich beispielsweise um ein XML-Objekt mit komplexem Inhalt, einschließlich eines Kommentars und einer Verarbeitungsanweisung:

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>

Wie im folgenden Beispiel dargestellt ist, können Sie nun mithilfe der Methoden comments() und processingInstructions() neue XML-Objekte, einen Kommentar und eine Verarbeitungsanweisung erstellen:

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

XML-Eigenschaften

Die XML-Klasse verfügt über fünf statische Eigenschaften:

  • Mit den Eigenschaften ignoreComments und ignoreProcessingInstructions wird festgelegt, ob Kommentare und Verarbeitungsanweisungen beim Analysieren von XML-Objekten ignoriert werden.

  • Mit der ignoreWhitespace-Eigenschaft wird festgelegt, ob Leerraumzeichen in Elementtags und eingebetteten Ausdrücken ignoriert werden, die nur durch Leerraumzeichen getrennt sind.

  • Die Eigenschaften prettyIndentund prettyPrinting werden verwendet, um den Text zu formatieren, der von den Methoden toString() und toXMLString() der XML-Klasse zurückgegeben wird.

Einzelheiten zu diesen Eigenschaften finden Sie im Handbuch ActionScript 3.0 Reference for the Adobe Flash Platform.

XML-Methoden

Die folgenden Methoden ermöglichen die Bearbeitung der hierarchischen Struktur von XML-Objekten:

  • appendChild()

  • child()

  • childIndex()

  • children()

  • descendants()

  • elements()

  • insertChildAfter()

  • insertChildBefore()

  • parent()

  • prependChild()

Die folgenden Methoden ermöglichen die Verarbeitung von XML-Objektattributen:

  • attribute()

  • attributes()

Die folgenden Methoden ermöglichen die Verarbeitung von XML-Objekteigenschaften:

  • hasOwnProperty()

  • propertyIsEnumerable()

  • replace()

  • setChildren()

Die folgenden Methoden sind zum Verwenden qualifizierter Namen und Namespaces bestimmt:

  • addNamespace()

  • inScopeNamespaces()

  • localName()

  • name()

  • namespace()

  • namespaceDeclarations()

  • removeNamespace()

  • setLocalName()

  • setName()

  • setNamespace()

Die folgenden Methoden dienen zum Verarbeiten und Ermitteln bestimmter Typen von XML-Inhalten:

  • comments()

  • hasComplexContent()

  • hasSimpleContent()

  • nodeKind()

  • processingInstructions()

  • text()

Die folgenden Methoden dienen zum Konvertieren in Strings und zum Formatieren von XML-Objekten:

  • defaultSettings()

  • setSettings()

  • settings()

  • normalize()

  • toString()

  • toXMLString()

Es gibt einige zusätzliche Methoden:

  • contains()

  • copy()

  • valueOf()

  • length()

Einzelheiten zu diesen Methoden finden Sie im Handbuch ActionScript 3.0 Reference for the Adobe Flash Platform.