XMLNode

Paket	flash.xml
Klasse	public class XMLNode
Vererbung	XMLNode Object
Unterklassen	XMLDocument

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Die XMLNode-Klasse ist das bisherige XML-Objekt aus ActionScript 2.0, das in ActionScript 3.0 umbenannt wurde. Verwenden Sie in ActionScript 3.0 stattdessen bevorzugt die neue übergeordnete XML-Klasse sowie deren zugehörige Klassen, die E4X (ECMAScript for XML) unterstützen. Die XMLNode-Klasse gibt es aus Gründen der Abwärtskompatibilität.

Beispiele anzeigen

Verwandte API-Elemente

XML
flash.xml.XMLDocument

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		attributes : Object Ein Objekt, das alle Attribute der angegebenen XMLNode-Instanz enthält.	XMLNode
		childNodes : Array [schreibgeschützt] Ein Array mit den untergeordneten Knoten des angegebenen XMLNode-Objekts.	XMLNode
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		firstChild : XMLNode Wertet das angegebene XMLDocument-Objekt aus und verweist auf den ersten untergeordneten (Child-)Knoten in der untergeordneten Liste des übergeordneten (Parent-)Knotens.	XMLNode
		lastChild : XMLNode Ein XMLNode-Wert, der auf den letzten untergeordneten Knoten in der untergeordneten Liste verweist.	XMLNode
		localName : String [schreibgeschützt] Der Teil des XML-Knotennamens, der den lokalen Namen angibt.	XMLNode
		namespaceURI : String [schreibgeschützt] Wenn der XML-Knoten ein Präfix aufweist, ist „namespaceURI“ der Wert der xmlns-Deklaration für dieses Präfix (der URI), der normalerweise als Namespace-URI bezeichnet wird.	XMLNode
		nextSibling : XMLNode Ein XMLNode-Wert, der auf den nächsten Geschwisterknoten in der untergeordneten Liste des übergeordneten Knotens verweist.	XMLNode
		nodeName : String Ein String, der den Knotennamen des XMLNode-Objekts angibt.	XMLNode
		nodeType : uint Eine nodeType-Konstante, die entweder XMLNodeType.ELEMENT_NODE (XML-Element) oder XMLNodeType.TEXT_NODE (Textknoten) ist.	XMLNode
		nodeValue : String Der Knotenwert des XMLDocument-Objekts.	XMLNode
		parentNode : XMLNode Ein XMLNode-Wert, der auf den übergeordneten Knoten des angegebenen XML-Objekts verweist, oder „null“ zurückgibt, wenn der Knoten keinen übergeordneten Knoten besitzt.	XMLNode
		prefix : String [schreibgeschützt] Der Teil des XML-Knotennamens, der das Präfix angibt.	XMLNode
		previousSibling : XMLNode Ein XMLNode-Wert, der auf den vorigen Geschwisterknoten in der untergeordneten Liste des übergeordneten Knotens verweist.	XMLNode

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		XMLNode(type:uint, value:String) Erstellt ein neues XMLNode-Objekt.	XMLNode
		appendChild(node:XMLNode):void Hängt den angegebenen Knoten an die untergeordnete (Child-)Liste des XML-Objekts an.	XMLNode
		cloneNode(deep:Boolean):XMLNode Erstellt einen neuen XML-Knoten vom gleichen Typ und mit dem gleichen Namen und Wert sowie den gleichen Attributen wie das angegebene XML-Objekt und gibt diesen zurück.	XMLNode
		getNamespaceForPrefix(prefix:String):String Gibt den Namespace-URI zurück, der mit dem angegebenen Präfix für den Knoten verknüpft ist.	XMLNode
		getPrefixForNamespace(ns:String):String Gibt das Präfix zurück, das mit dem angegebenen Namespace-URI für den Knoten verknüpft ist.	XMLNode
		hasChildNodes():Boolean Gibt an, ob dem jeweiligen XMLNode-Objekt weitere Knoten untergeordnet sind.	XMLNode
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		insertBefore(node:XMLNode, before:XMLNode):void Fügt in die untergeordnete (Child-)Liste des XML-Objekts vor dem beforeNode-Knoten einen neuen untergeordneten Knoten ein.	XMLNode
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeNode():void Entfernt das angegebene XML-Objekt aus dem übergeordneten Knoten.	XMLNode
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Wertet das angegebene XMLNode-Objekt aus, erstellt eine Textdarstellung der XML-Struktur mit Knoten, untergeordneten (Child-)Knoten und Attributen und gibt das Ergebnis als String zurück.	XMLNode
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Eigenschaftendetails

attributes

Eigenschaft

attributes:Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Ein Objekt, das alle Attribute der angegebenen XMLNode-Instanz enthält. Das XMLNode.attributes-Objekt enthält für jedes Attribut der XMLNode-Instanz jeweils eine Variable. Da diese Variablen als Teil des Objekts definiert sind, werden sie im Allgemeinen als Eigenschaften des Objekts bezeichnet. Der Wert jedes Attributs wird in der entsprechenden Eigenschaft als String gespeichert. Bei einem Attribut mit der Bezeichnung color rufen Sie dessen Wert beispielsweise ab, indem Sie color als Eigenschaftennamen angeben. Dies wird im folgenden Code demonstriert:

	 var myColor:String = doc.firstChild.attributes.color

Implementierung
public function get attributes():Object
public function set attributes(value:Object):void

childNodes

Eigenschaft

childNodes:Array [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Ein Array mit den untergeordneten Knoten des angegebenen XMLNode-Objekts. Jedes Element im Array ist ein Verweis auf ein XMLNode-Objekt, das einen untergeordneten Knoten darstellt. Die Eigenschaft ist schreibgeschützt und kann nicht zum Bearbeiten von untergeordneten Knoten verwendet werden. Verwenden Sie zum Bearbeiten von untergeordneten Knoten die Methoden appendChild(), insertBefore() und removeNode().

Für Textknoten ist diese Eigenschaft undefiniert (nodeType == 3).

Implementierung
public function get childNodes():Array

Verwandte API-Elemente

XMLNode.nodeType
XMLNode.appendChild()
XMLNode.insertBefore()
XMLNode.removeNode()

firstChild

Eigenschaft

public var firstChild:XMLNode

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Wertet das angegebene XMLDocument-Objekt aus und verweist auf den ersten untergeordneten (Child-)Knoten in der untergeordneten Liste des übergeordneten (Parent-)Knotens. Diese Eigenschaft ist null, wenn der Knoten über keine untergeordneten Knoten verfügt. Diese Eigenschaft ist undefined, wenn der Knoten ein Textknoten ist. Die Eigenschaft ist schreibgeschützt und kann nicht zum Bearbeiten von untergeordneten Knoten verwendet werden. Verwenden Sie zum Bearbeiten von untergeordneten Knoten die Methoden appendChild(), insertBefore() sowie removeNode().

Verwandte API-Elemente

XMLNode.appendChild()
XMLNode.insertBefore()
XMLNode.removeNode()

lastChild

Eigenschaft

public var lastChild:XMLNode

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Ein XMLNode-Wert, der auf den letzten untergeordneten Knoten in der untergeordneten Liste verweist. Die Eigenschaft XMLNode.lastChild ist null, wenn der Knoten über keine untergeordneten Knoten verfügt. Diese Eigenschaft kann nicht zum Bearbeiten von untergeordneten Knoten verwendet werden. Verwenden Sie zum Bearbeiten von untergeordneten Knoten die Methoden appendChild(), insertBefore() und removeNode().

Verwandte API-Elemente

XMLNode.appendChild()
XMLNode.insertBefore()
XMLNode.removeNode()

localName

Eigenschaft

localName:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Der Teil des XML-Knotennamens, der den lokalen Namen angibt. Dies ist der Elementname ohne Namespace-Präfix. So hat beispielsweise der Knoten <contact:mailbox/>bob@example.com</contact:mailbox> den lokalen Namen „mailbox“ und das Präfix „contact“, die den vollständigen Elementnamen „contact.mailbox“ bilden.

Auf das Namespace-Präfix kann über die prefix-Eigenschaft des XML-Knotenobjekts zugegriffen werden. Die nodeName-Eigenschaft gibt den vollständigen Namen (einschließlich Präfix und lokalem Namen) zurück.

Implementierung
public function get localName():String

namespaceURI

Eigenschaft

namespaceURI:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Weist der XML-Knoten ein Präfix auf, ist namespaceURI der Wert der xmlns-Deklaration für dieses Präfix (der URI), der normalerweise als Namespace-URI bezeichnet wird. Die Deklaration xmlns befindet sich im aktuellen Knoten oder in einem Knoten, der in der XML-Hierarchie höher liegt.

Weist der XML-Knoten kein Präfix auf, hängt der Wert der Eigenschaft namespaceURI davon ab, ob ein Standard-Namespace definiert ist (wie in xmlns="http://www.example.com/"). Wenn ein Standard-Namespace vorhanden ist, ist der Wert der Eigenschaft namespaceURI gleich dem Wert des Standard-Namespace. Wenn kein Standard-Namespace vorhanden ist, wird für die Eigenschaft namespaceURI dieses Knotens ein leerer String ("") eingetragen.

Zum Ermitteln des Namespace für ein bestimmtes Präfix können Sie die getNamespaceForPrefix()-Methode verwenden. Die namespaceURI-Eigenschaft gibt das mit dem Knotennamen verknüpfte Präfix zurück.

Implementierung
public function get namespaceURI():String

Verwandte API-Elemente

getNamespaceForPrefix()
getPrefixForNamespace()

nextSibling

Eigenschaft

public var nextSibling:XMLNode

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Ein XMLNode-Wert, der auf den nächsten Geschwisterknoten in der untergeordneten Liste des übergeordneten Knotens verweist. Diese Eigenschaft hat den Wert null, wenn der Knoten keinen nächsten Geschwisterknoten besitzt. Diese Eigenschaft kann nicht zum Bearbeiten von untergeordneten Knoten verwendet werden. Verwenden Sie zum Bearbeiten von untergeordneten Knoten die Methoden appendChild(), insertBefore() und removeNode().

Verwandte API-Elemente

XMLNode.firstChild
XMLNode.appendChild()
XMLNode.insertBefore()
XMLNode.removeNode()

nodeName

Eigenschaft

public var nodeName:String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Ein String, der den Knotennamen des XMLNode-Objekts angibt. Wenn das XMLNode-Objekt ein XML-Element ist (nodeType == 1), entspricht nodeName dem Namen des Tags für den Knoten in der XML-Datei. TITLE ist beispielsweise der nodeName eines HTML-TITLE-Tags. Wenn es sich bei dem XMLNode-Objekt um einen Textknoten handelt (nodeType == 3), weist „nodeName“ den Wert null auf.

Verwandte API-Elemente

XMLNode.nodeType

nodeType

Eigenschaft

public var nodeType:uint

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Eine nodeType-Konstante, die entweder XMLNodeType.ELEMENT_NODE (XML-Element) oder XMLNodeType.TEXT_NODE (Textknoten) beträgt.

nodeType ist ein numerischer Wert aus der NodeType-Aufzählung in der W3C DOM Level 1-Empfehlung: http://www.w3.org/tr/1998/REC-DOM-Level-1-19981001/level-one-core.html. Die folgende Tabelle enthält die entsprechenden Werte:

Ganzzahl	Definierte Konstante
1	ELEMENT_NODE
3	TEXT_NODE
5	ENTITY_REFERENCE_NODE
7	PROCESSING_INSTRUCTION_NODE
9	DOCUMENT_NODE
11	DOCUMENT_FRAGMENT_NODE

Die in Flash Player integrierte XMLNode-Klasse unterstützt nur die Typen XMLNodeType.ELEMENT_NODE und XMLNodeType.TEXT_NODE.

Verwandte API-Elemente

XMLNodeType.TEXT_NODE
XMLNodeType.ELEMENT_NODE

nodeValue

Eigenschaft

public var nodeValue:String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Der Knotenwert des XMLDocument-Objekts. Wenn es sich bei dem XMLDocument-Objekt um einen Textknoten handelt, ist der nodeType 3 und der nodeValue ist der Text des Knotens. Ist das XMLDocument-Objekt ein XML-Element (nodeType ist 1), hat nodeValue den Wert null und ist schreibgeschützt.

Verwandte API-Elemente

XMLNode.nodeType

parentNode

Eigenschaft

public var parentNode:XMLNode

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Ein XMLNode-Wert, der auf den übergeordneten Konten des angegebenen XML-Objekts verweist, oder null zurückgibt, wenn der Knoten keinen übergeordneten Knoten besitzt. Die Eigenschaft ist schreibgeschützt und kann nicht zum Bearbeiten von untergeordneten Knoten verwendet werden. Verwenden Sie zum Bearbeiten von untergeordneten Knoten die Methoden appendChild(), insertBefore() sowie removeNode().

Verwandte API-Elemente

XMLNode.appendChild()
XMLNode.insertBefore()
XMLNode.removeNode()

prefix

Eigenschaft

prefix:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Der Teil des XML-Knotennamens, der das Präfix angibt. So hat beispielsweise der Knoten <contact:mailbox/>bob@example.com</contact:mailbox> den lokalen Namen „mailbox“ und das Präfix „contact“, die den vollständigen Elementnamen „contact.mailbox“ bilden.

Die nodeName-Eigenschaft eines XML-Knotenobjekts gibt den vollständigen Namen (einschließlich Präfix und lokalem Namen) zurück. Auf den Teil des Elementnamens, der den lokalen Namen darstellt, kann über die localName-Eigenschaft zugegriffen werden.

Implementierung
public function get prefix():String

previousSibling

Eigenschaft

public var previousSibling:XMLNode

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Ein XMLNode-Wert, der auf den vorigen Geschwisterknoten in der untergeordneten Liste des übergeordneten Knotens verweist. Die Eigenschaft hat den Wert „null“, wenn kein vorheriger Geschwisterknoten vorhanden ist. Diese Eigenschaft kann nicht zum Bearbeiten von untergeordneten Knoten verwendet werden. Verwenden Sie zum Bearbeiten von untergeordneten Knoten die Methoden appendChild(), insertBefore() und removeNode().

Verwandte API-Elemente

XMLNode.lastChild
XMLNode.appendChild()
XMLNode.insertBefore()
XMLNode.removeNode()

Konstruktordetails

()

Konstruktor

public function XMLNode(type:uint, value:String)

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt ein neues XMLNode-Objekt. Vor dem Aufruf einer Methode der XMLNode-Klasse muss der Konstruktor zum Erstellen eines XMLNode-Objekts verwendet werden.

Hinweis: Verwenden Sie die createElement()- und createTextNode()-Methode, um einer XML-Dokumentstruktur Elemente und Textknoten hinzuzufügen.

Parameter

	`type:uint` — Knotentyp: Entweder 1 (für ein XML-Element) oder 3 (für einen Textknoten).

	`value:String` — Der XML-Text, der zum Erstellen des neuen XMLNode-Objekts analysiert wurde.

Verwandte API-Elemente

XMLDocument.createElement()
XMLDocument.createTextNode()

Methodendetails

appendChild

()

Methode

public function appendChild(node:XMLNode):void

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Hängt den angegebenen Knoten an die untergeordnete (Child-)Liste des XML-Objekts an. Diese Methode wirkt sich direkt auf den Knoten aus, auf den über den Parameter childNode verwiesen wird, hängt jedoch keine Kopie des Knotens an. Wenn der anzuhängende Knoten bereits in einer anderen Baumstruktur vorhanden ist, wird er beim Anhängen an die neue Position aus der aktuellen Position entfernt. Wenn der Parameter childNode auf einen Knoten verweist, der bereits in einer anderen XML-Baumstruktur vorhanden ist, wird der angehängte untergeordnete (Child-)Knoten erst in der neuen Baumstruktur platziert, nachdem er aus dem vorhandenen übergeordneten Knoten entfernt wurde.

Parameter

node:XMLNode — Ein XMLNode-Objekt, das den von seiner aktuellen Position in die untergeordnete (Child-)Liste des Objekts my_xml zu verschiebenden Knoten darstellt.

cloneNode

()

Methode

public function cloneNode(deep:Boolean):XMLNode

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt einen neuen XML-Knoten vom gleichen Typ und mit dem gleichen Namen und Wert sowie den gleichen Attributen wie das angegebene XML-Objekt und gibt diesen zurück. Wenn deep auf true gesetzt ist, werden alle untergeordneten Knoten rekursiv geklont, wodurch eine exakte Kopie der Dokumentstruktur des ursprünglichen Objekts entsteht.

Der zurückgegebene Klon ist nicht mehr mit der Struktur des geklonten Knotens verknüpft. Somit haben nextSibling, parentNode und previousSibling alle den Wert null. Wenn der Parameter deep auf false gesetzt ist oder der my_xml-Knoten über keine untergeordnete Knoten verfügt, haben firstChild und lastChild ebenfalls den Wert „null“.

Parameter

deep:Boolean — Ein boolescher Wert. Wenn er auf true gesetzt ist, werden die untergeordneten Knoten des angegebenen XML-Objekts rekursiv geklont.

Rückgabewerte

XMLNode — Ein XMLNode-Objekt.

getNamespaceForPrefix

()

Methode

public function getNamespaceForPrefix(prefix:String):String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den Namespace-URI zurück, der mit dem angegebenen Präfix für den Knoten verknüpft ist. Zum Bestimmen des URI sucht getPrefixForNamespace() bei Bedarf ab dem Knoten in der XML-Hierarchie aufwärts und gibt den Namespace-URI der ersten xmlns-Deklaration für das gegebene prefix zurück.

Ist für dieses Präfix kein Namespace definiert, gibt die Methode null zurück.

Wenn Sie einen leeren String ("") als prefix angeben und ein Standard-Namespace für den Knoten definiert ist (wie in xmlns="http://www.example.com/"), gibt die Methode den URI des Standard-Namespace zurück.

Parameter

prefix:String — Das Präfix, für das die Methode den verknüpften Namespace zurückgibt.

Rückgabewerte

String — Der mit dem angegebenen Präfix verknüpfte Namespace.

Verwandte API-Elemente

XMLNode.getPrefixForNamespace()
XMLNode.namespaceURI

getPrefixForNamespace

()

Methode

public function getPrefixForNamespace(ns:String):String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt das Präfix zurück, das mit dem angegebenen Namespace-URI für den Knoten verknüpft ist. Zum Bestimmen des Präfix sucht getPrefixForNamespace() bei Bedarf ab dem Knoten in der XML-Hierarchie aufwärts und gibt das Präfix der ersten xmlns-Deklaration mit einem Namespace-URI zurück, die ns entspricht.

Wenn keine xmlns-Zuweisung für den gegebenen URI vorhanden ist, gibt die Methode null zurück. Wenn eine xmlns-Zuweisung für den gegebenen URI vorhanden ist, ohne dass ein Präfix verknüpft wurde, gibt die Methode einen leeren String ("") zurück.

Parameter

ns:String — Der Namespace-URI, für den die Methode das verknüpfte Präfix zurückgibt.

Rückgabewerte

String — Das mit dem angegebenen Namespace verknüpfte Präfix.

Verwandte API-Elemente

XMLNode.getNamespaceForPrefix()
XMLNode.namespaceURI

hasChildNodes

()

Methode

public function hasChildNodes():Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt an, ob dem jeweiligen XMLNode-Objekt weitere Knoten untergeordnet sind. Diese Eigenschaft ist true, wenn dem angegebenen XMLNode-Objekt weitere Knoten untergeordnet sind. Andernfalls ist es false.

Rückgabewerte

Boolean — Gibt true zurück, wenn dem angegebenen XMLNode-Objekt weitere Knoten untergeordnet sind, andernfalls false.

insertBefore

()

Methode

public function insertBefore(node:XMLNode, before:XMLNode):void

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Fügt einen neuen untergeordneten Knoten vor dem beforeNode-Knoten in die untergeordnete (Child-)Liste des XML-Objekts ein. Wenn der Parameter beforeNode nicht definiert oder „null“ ist, wird der Knoten mit der appendChild()-Methode hinzugefügt. Wenn beforeNode kein untergeordneter Knoten von my_xml ist, schlägt das Einfügen fehl.

Parameter

	`node:XMLNode` — Das einzufügende XMLNode-Objekt.

	`before:XMLNode` — Das XMLNode-Objekt vor dem Einfügepunkt für `childNode`.

Verwandte API-Elemente

XMLNode.cloneNode()

removeNode

()

Methode

public function removeNode():void

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Entfernt das angegebene XML-Objekt aus dem übergeordneten Knoten. Alle untergeordneten Elemente des Knotens werden ebenfalls gelöscht.

toString

()

Methode

public function toString():String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Wertet das angegebene XMLNode-Objekt aus, erstellt eine Textdarstellung der XML-Struktur mit Knoten, untergeordneten (Child-)Knoten und Attributen und gibt das Ergebnis als String zurück.

Bei XMLDocument-Objekten der obersten Ebene (mit dem Konstruktor erstellt) gibt die XMLDocument.toString()-Methode die XML-Deklaration des Dokuments aus (gespeichert in der XMLDocument.xmlDecl-Eigenschaft), gefolgt von der DOCTYPE-Deklaration des Dokuments (gespeichert in der XMLDocument.docTypeDecl-Eigenschaft) und der Textdarstellung aller XML-Knoten im Objekt. Die XML-Deklaration wird nicht ausgegeben, wenn die Eigenschaft XMLDocument.xmlDecl den Wert null hat. Die DOCTYPE-Deklaration wird nicht ausgegeben, wenn die Eigenschaft XMLDocument.docTypeDecl den Wert null hat.

Rückgabewerte

String — Der String, der das XMLNode-Objekt angibt.

Verwandte API-Elemente

XMLDocument.docTypeDecl
XMLDocument.xmlDecl

Beispiele Verwendung dieses Beispiels

XMLDocumentExample.as

Im folgenden Beispiel werden die Klassen XMLDocument und XMLNode zum Analysieren und Formatieren eines XML-Dokuments verwendet. Im Beispiel wird keine externe XML-Datei geladen, sondern es wird eine XML-Klasse der obersten Ebene verwendet, um ein XML-Dokument zu erstellen und dieses anschließend zu analysieren.

package {
    import flash.display.Sprite;
    import flash.xml.XMLDocument;
    import flash.xml.XMLNode;
    import flash.xml.XMLNodeType;

    public class XMLDocumentExample extends Sprite {
        public function XMLDocumentExample() {
            var result:XMLDocument = new XMLDocument();
            result.ignoreWhite = true;
            result.parseXML(getXMLString());

            var books:Array = parseBooks(result.firstChild);
            trace("books: \n" + books);
        }

        private function parseBooks(node:XMLNode):Array {
            var books:Array = new Array();

            var kids:Array = node.childNodes;
            for each(var item:XMLNode in kids) {
                parseBook(item, books);
            }

            return books;
        }

        private function parseBook(node:XMLNode, books:Array):void {
            var item:Book = new Book();
            item.setPublisher(node.attributes.publisher);
            item.setName(node.attributes.name);
            books.push(item);
        }

        private function getXMLString():String {
            var list:XML = <books>
                                <book publisher="Addison-Wesley" name="Design Patterns" />
                                <book publisher="Addison-Wesley" name="The Pragmatic Programmer" />
                                <book publisher="Addison-Wesley" name="Test Driven Development" />
                                <book publisher="Addison-Wesley" name="Refactoring to Patterns" />
                                <book publisher="O'Reilly Media" name="The Cathedral & the Bazaar" />
                                <book publisher="O'Reilly Media" name="Unit Test Frameworks" />
                            </books>;
            return list.toXMLString();
        }
    }

}
class Book {
    private var publisher:String;
    private var name:String;

    public function setPublisher(publisher:String):void {
        this.publisher = publisher;
    }

    public function setName(name:String):void {
        this.name = name;
    }

    public function toString():String {
        return "[Book name: " + name + " publisher: " + publisher + "]\n";
    }
}

Rechtliche Hinweise | Onlinedatenschutzerklärung

XMLNode - AS3

Paketex

Sprachelemente

Anhänge

Paket flash.xml

attributes

childNodes

firstChild

lastChild

localName

namespaceURI

nextSibling

nodeName

nodeType

nodeValue

parentNode

prefix

previousSibling

XMLNode

appendChild

cloneNode

getNamespaceForPrefix

getPrefixForNamespace

hasChildNodes

insertBefore

removeNode

toString