XMLDocument  - AS3

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.

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']);
     

     <c id='1' />
     

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;
     

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.

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.

Verwandte API-Elemente

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.

Parameter

Verwandte API-Elemente

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.

Parameter

Verwandte API-Elemente

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.

Parameter

Gibt das XML-Objekt als String zurück.