flash.xmlXMLNode Die XMLNode-Klasse ist das bisherige XML-Objekt aus ActionScript 2.0, das in ActionScript 3.0 umbenannt wurde.Object 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. 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"; } } XMLflash.xml.XMLDocumentXMLNode Erstellt ein neues XMLNode-Objekt.typeuintKnotentyp: Entweder 1 (für ein XML-Element) oder 3 (für einen Textknoten). valueStringDer XML-Text, der zum Erstellen des neuen XMLNode-Objekts analysiert wurde. 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.

XMLDocument.createElement()XMLDocument.createTextNode()
appendChild Hängt den angegebenen Knoten an die untergeordnete (Child-)Liste des XML-Objekts an.nodeflash.xml:XMLNodeEin XMLNode-Objekt, das den von seiner aktuellen Position in die untergeordnete (Child-)Liste des Objekts my_xml zu verschiebenden Knoten darstellt. 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. cloneNode 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.Ein XMLNode-Objekt. flash.xml:XMLNodedeepBooleanEin boolescher Wert. Wenn er auf true gesetzt ist, werden die untergeordneten Knoten des angegebenen XML-Objekts rekursiv geklont. 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“.

getNamespaceForPrefix Gibt den Namespace-URI zurück, der mit dem angegebenen Präfix für den Knoten verknüpft ist.Der mit dem angegebenen Präfix verknüpfte Namespace. StringprefixStringDas Präfix, für das die Methode den verknüpften Namespace zurückgibt. 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.

XMLNode.getPrefixForNamespace()XMLNode.namespaceURI
getPrefixForNamespace Gibt das Präfix zurück, das mit dem angegebenen Namespace-URI für den Knoten verknüpft ist.Das mit dem angegebenen Namespace verknüpfte Präfix. StringnsStringDer Namespace-URI, für den die Methode das verknüpfte Präfix zurückgibt. 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.

XMLNode.getNamespaceForPrefix()XMLNode.namespaceURI
hasChildNodes Gibt an, ob dem jeweiligen XMLNode-Objekt weitere Knoten untergeordnet sind.Gibt true zurück, wenn dem angegebenen XMLNode-Objekt weitere Knoten untergeordnet sind, andernfalls false. Boolean 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. insertBefore Fügt in die untergeordnete (Child-)Liste des XML-Objekts vor dem beforeNode-Knoten einen neuen untergeordneten Knoten ein.nodeflash.xml:XMLNodeDas einzufügende XMLNode-Objekt. beforeflash.xml:XMLNodeDas XMLNode-Objekt vor dem Einfügepunkt für childNode. 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. XMLNode.cloneNode()removeNode Entfernt das angegebene XML-Objekt aus dem übergeordneten Knoten. Entfernt das angegebene XML-Objekt aus dem übergeordneten Knoten. Alle untergeordneten Elemente des Knotens werden ebenfalls gelöscht. toString 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.Der String, der das XMLNode-Objekt angibt. 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.

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.

XMLDocument.docTypeDeclXMLDocument.xmlDecl
firstChild Wertet das angegebene XMLDocument-Objekt aus und verweist auf den ersten untergeordneten (Child-)Knoten in der untergeordneten Liste des übergeordneten (Parent-)Knotens.flash.xml:XMLNode 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(). XMLNode.appendChild()XMLNode.insertBefore()XMLNode.removeNode()lastChild Ein XMLNode-Wert, der auf den letzten untergeordneten Knoten in der untergeordneten Liste verweist.flash.xml:XMLNode 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(). XMLNode.appendChild()XMLNode.insertBefore()XMLNode.removeNode()nextSibling Ein XMLNode-Wert, der auf den nächsten Geschwisterknoten in der untergeordneten Liste des übergeordneten Knotens verweist.flash.xml:XMLNode 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(). XMLNode.firstChildXMLNode.appendChild()XMLNode.insertBefore()XMLNode.removeNode()nodeName Ein String, der den Knotennamen des XMLNode-Objekts angibt.String 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. XMLNode.nodeTypenodeType Eine nodeType-Konstante, die entweder XMLNodeType.ELEMENT_NODE (XML-Element) oder XMLNodeType.TEXT_NODE (Textknoten) ist.uint 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:

4CDATA_SECTION_NODEGanzzahlDefinierte Konstante1ELEMENT_NODE3TEXT_NODE5ENTITY_REFERENCE_NODE7PROCESSING_INSTRUCTION_NODE9DOCUMENT_NODE11DOCUMENT_FRAGMENT_NODE

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

XMLNodeType.TEXT_NODEXMLNodeType.ELEMENT_NODE
nodeValue Der Knotenwert des XMLDocument-Objekts.String 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. XMLNode.nodeTypeparentNode Ein XMLNode-Wert, der auf den übergeordneten Knoten des angegebenen XML-Objekts verweist, oder „null“ zurückgibt, wenn der Knoten keinen übergeordneten Knoten besitzt.flash.xml:XMLNode 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(). XMLNode.appendChild()XMLNode.insertBefore()XMLNode.removeNode()previousSibling Ein XMLNode-Wert, der auf den vorigen Geschwisterknoten in der untergeordneten Liste des übergeordneten Knotens verweist.flash.xml:XMLNode 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(). XMLNode.lastChildXMLNode.appendChild()XMLNode.insertBefore()XMLNode.removeNode()attributes Ein Objekt, das alle Attribute der angegebenen XMLNode-Instanz enthält.Object 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
	 
childNodes Ein Array mit den untergeordneten Knoten des angegebenen XMLNode-Objekts.Array 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).

XMLNode.nodeTypeXMLNode.appendChild()XMLNode.insertBefore()XMLNode.removeNode()
localName Der Teil des XML-Knotennamens, der den lokalen Namen angibt.String 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.

namespaceURI 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.StringDer URI des Namespace, in den das Präfix des XML-Knotens aufgelöst wird. 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.

getNamespaceForPrefix()getPrefixForNamespace()
prefix Der Teil des XML-Knotennamens, der das Präfix angibt.String 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.

XMLNodeType Die XMLNodeType-Klasse enthält Konstanten, die mit XMLNode.nodeType verwendet werden.Object Die XMLNodeType-Klasse enthält Konstanten, die mit XMLNode.nodeType verwendet werden. Die Werte werden durch die NodeType-Aufzählung in der W3C DOM Level 1-Empfehlung definiert: http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html XMLNode.nodeTypeELEMENT_NODE Gibt an, dass es sich bei dem Knoten um ein Element handelt.1uint Gibt an, dass es sich bei dem Knoten um ein Element handelt. Diese Konstante wird mit XMLNode.nodeType verwendet. Der Wert wird durch die NodeType-Aufzählung in der W3C DOM Level 1-Empfehlung definiert: http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html XMLNode.nodeTypeTEXT_NODE Gibt an, dass es sich bei dem Knoten um einen Textknoten handelt.3uint Gibt an, dass es sich bei dem Knoten um einen Textknoten handelt. Diese Konstante wird mit XMLNode.nodeType verwendet. Der Wert wird durch die NodeType-Aufzählung in der W3C DOM Level 1-Empfehlung definiert: http://www.w3.org/TR/1998/REC-DOM-Level-1-19981001/level-one-core.html XMLNode.nodeTypeXMLDocument Die XMLDocument-Klasse stellt das bisherige XML-Objekt aus ActionScript 2.0 dar.flash.xml:XMLNode Die XMLDocument-Klasse stellt das bisherige XML-Objekt aus ActionScript 2.0 dar. Es wurde in ActionScript 3.0 in „XMLDocument“ umbenannt, um Namenskonflikte mit der neuen XML-Klasse von ActionScript 3.0 zu vermeiden. Verwenden Sie in ActionScript 3.0 stattdessen bevorzugt die neue XML-Klasse sowie deren zugehörige Klassen, die E4X (ECMAScript for XML) unterstützen.

Die XMLDocument-Klasse sowie „XMLNode“ und „XMLNodeType“ gibt es aus Gründen der Abwärtskompatibilität. Die Funktionen zum Laden von XML-Dokumenten finden Sie nun in der URLLoader-Klasse.

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"; } }
flash.net.URLLoaderXML-KlasseXMLDocument Erstellt ein neues XMLDocument-Objekt.sourceStringnullDer XML-Text, der zum Erstellen des neuen XMLDocument-Objekts analysiert wurde. Erstellt ein neues XMLDocument-Objekt. Vor dem Aufruf einer Methode der XMLDocument-Klasse muss der Konstruktor zum Erstellen eines XMLDocument-Objekts verwendet werden.

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

XMLDocument.createElement()XMLDocument.createTextNode()
createElement Erstellt ein neues XMLNode-Objekt mit dem im Parameter angegebenen Namen.Ein XMLNode-Objekt. flash.xml:XMLNodenameStringDer Tag-Name des XMLDocument-Elements, das erstellt werden soll. Erstellt ein neues XMLNode-Objekt mit dem im Parameter angegebenen Namen. Der neue Knoten hat zunächst keinen übergeordneten, keine untergeordneten und keine Geschwisterknoten. Die Methode gibt einen Verweis auf das neu erstellte XMLNode-Objekt zurück, das das Element darstellt. Diese Methode und die XMLDocument.createTextNode()-Methoden sind die Konstruktormethoden zum Erstellen von Knoten für ein XMLDocument-Objekt. XMLDocument.createTextNode()createTextNode Erstellt einen neuen XML-Textknoten mit dem angegebenen Text.Ein XMLNode-Objekt. flash.xml:XMLNodetextStringDer Text, der zum Erstellen des neuen Textknotens verwendet wird. Erstellt einen neuen XML-Textknoten mit dem angegebenen Text. Der neue Knoten hat zunächst keinen übergeordneten Knoten. Textknoten können keine untergeordneten oder Geschwisterknoten aufweisen. Diese Methode gibt einen Verweis auf das XMLDocument-Objekt zurück, das den neuen Textknoten darstellt. Diese Methode und die XMLDocument.createElement()-Methoden sind die Konstruktormethoden zum Erstellen von Knoten für ein XMLDocument-Objekt. XMLDocument.createElement()parseXML Analysiert den im Parameter „value“ angegebenen XML-Text und fügt die dabei entstehende XML-Struktur in das angegebene XMLDocument-Objekt ein.sourceStringDer XML-Text, der analysiert und an das angegebene XMLDocument-Objekt übergeben werden soll. Analysiert den im Parameter value angegebenen XML-Text und fügt die dabei entstehende XML-Struktur in das angegebene XMLDocument-Objekt ein. Alle im XMLDocument-Objekt vorhandenen Strukturen werden verworfen. toString Gibt das XML-Objekt als String zurück.Eine Stringdarstellung des XML-Objekts. String Gibt das XML-Objekt als String zurück. docTypeDecl Gibt Informationen über die DOCTYPE-Deklaration eines XML-Dokuments an.nullObject Gibt Informationen über die DOCTYPE-Deklaration eines XML-Dokuments an. Nachdem der XML-Text in ein XMLDocument-Objekt eingelesen wurde, wird die XMLDocument.docTypeDecl-Eigenschaft des XMLDocument-Objekts auf den Text der DOCTYPE-Deklaration des XML-Dokuments gesetzt (beispielsweise <!DOCTYPE greeting SYSTEM "hello.dtd">). Diese Eigenschaft wird anhand einer Stringdarstellung der DOCTYPE-Deklaration und nicht anhand eines XMLNode-Objekts festgelegt.

Der XML-Parser vorheriger Versionen von ActionScript ist kein validierender Parser. Die DOCTYPE-Deklaration wird vom Parser gelesen und in der XMLDocument.docTypeDecl-Eigenschaft gespeichert, eine Validierung der DTD wird jedoch nicht durchgeführt.

Wenn bei der Analyse keine DOCTYPE-Deklaration gefunden wurde, wird die Eigenschaft XMLDocument.docTypeDecl auf null gesetzt. Die XML.toString()-Methoden gibt den Inhalt von XML.docTypeDecl unmittelbar nach der in XML.xmlDecl gespeicherten XML-Deklaration und vor jedem anderen Text im XML-Objekt aus. Wenn XMLDocument.docTypeDecl den Wert „null“ aufweist, wird keine DOCTYPE-Deklaration ausgegeben.

idMap Ein Objekt mit den XML-Knoten, denen ein id-Attribut zugeordnet ist.unknownObject Ein Objekt mit den XML-Knoten, denen ein id-Attribut zugeordnet ist. Die Namen der Objekteigenschaften (jeweils mit einem Knoten) entsprechen den Werten der id-Attribute.

Betrachten Sie das folgende XMLDocument-Objekt:

<employee id='41'> <name> John Doe </name> <address> 601 Townsend St. </address> </employee> <employee id='42'> <name> Jane Q. Public </name> </employee> <department id="IT"> Information Technology </department>

In diesem Beispiel ist die idMap-Eigenschaft dieses XMLDocument-Objekts ein Objekt mit drei Eigenschaften: 41, 42 und IT. Jede dieser Eigenschaften ist ein XMLNode mit dem entsprechenden id-Wert. Die Eigenschaft IT des Objekts idMap befindet sich beispielsweise in diesem Knoten:

<department id="IT"> Information Technology </department>

Sie müssen die parseXML()-Methode auf das XMLDocument-Objekt anwenden, damit die idMap-Eigenschaft instanziiert wird.

Sind mehrere XMLNode-Objekte mit dem gleichen id-Wert vorhanden, ist die entsprechende Eigenschaft des idNode-Objekts die des zuletzt analysierten Knotens. Beispiel:

var x1:XML = new XMLDocument("<a id='1'><b id='2' /><c id='1' /></a>"); x2 = new XMLDocument(); x2.parseXML(x1); trace(x2.idMap['1']); Dadurch wird der <c>-Knoten ausgegeben: <c id='1' />
ignoreWhite Ist diese Eigenschaft auf „true“ gesetzt, werden Textknoten, die nur Leerräume enthalten, bei der Analyse gelöscht.falseBoolean Ist diese Eigenschaft auf true gesetzt, werden Textknoten, die nur Leerräume enthalten, bei der Analyse gelöscht. Textknoten mit voran- oder nachgestellten Leerzeichen sind nicht davon betroffen. Der Standardwert ist false.

Sie können die ignoreWhite-Eigenschaft für einzelne XMLDocument-Objekte einstellen, wie im folgenden Code dargestellt:

my_xml.ignoreWhite = true;
xmlDecl Ein String, der Informationen zur XML-Deklaration eines Dokuments angibt.nullObject Ein String, der Informationen zur XML-Deklaration eines Dokuments angibt. Nachdem das XML-Dokument in ein XMLDocument-Objekt eingelesen wurde, wird diese Eigenschaft auf den Text der XML-Deklaration des Dokuments gesetzt. Diese Eigenschaft wird anhand einer Stringdarstellung der XML-Deklaration und nicht anhand eines XMLNode-Objekts festgelegt. Wenn bei der Analyse keine XML-Deklaration gefunden wurde, wird die Eigenschaft auf null gesetzt. Die XMLDocument.toString()-Methode gibt den Inhalt der XML.xmlDecl-Eigenschaft vor sonstigem Text im XML-Objekt aus. Wenn die XML.xmlDecl-Eigenschaft den Wert null enthält, wird keine XML-Deklaration ausgegeben.