XMLList

Paket	Oberste Ebene
Klasse	public final dynamic class XMLList
Vererbung	XMLList Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Die XMLList-Klasse enthält Methoden zur Arbeit mit einem oder mehreren XML-Elementen. Ein XMLList-Objekt kann eines oder mehrere XML-Objekte oder -Elemente (einschließlich mehrere Knoten und Attribute) repräsentieren. Dadurch haben Sie die Möglichkeit, Methoden für die Elemente als Gruppe oder für einzelne Elemente in der Sammlung aufzurufen.

Wenn ein XMLList-Objekt nur ein XML-Element aufweist, können Sie die Methoden der XML-Klasse direkt auf das XMLList-Objekt anwenden. Im folgenden Beispiel ist example.two ein XMLList-Objekt mit einer Länge von 1, sodass Sie eine XML-Methode darauf anwenden können.

 var example2 = <example><two>2</two></example>;

Wenn Sie versuchen, Methoden der XML-Klasse auf ein XMLList-Objekt anzuwenden, dass mehrere XML-Objekte enthält, wird eine Ausnahme ausgelöst. Durchlaufen Sie stattdessen die XMLList-Sammlung (beispielsweise mit einer for each..in-Anweisung), und wenden Sie Methoden auf jedes einzelne XML-Objekt in der Sammlung an.

Beispiele anzeigen

Verwandte API-Elemente

XML
for each..in
Namespace
QName

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		XMLList(value:Object) Erstellt ein neues XMLList-Objekt.	XMLList
		attribute(attributeName:*):XMLList Ruft die attribute()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit den Ergebnissen zurück.	XMLList
		attributes():XMLList Ruft die attributes()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit Attributen für jedes XML-Objekt zurück.	XMLList
		child(propertyName:Object):XMLList Ruft die child()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt zurück, das die Ergebnisse in der richtigen Reihenfolge enthält.	XMLList
		children():XMLList Ruft die children()-Methode für jedes XML-Objekt zurück und gibt ein XMLList-Objekt mit den Ergebnissen zurück.	XMLList
		comments():XMLList Ruft die comments()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit Kommentaren zurück.	XMLList
		contains(value:XML):Boolean Prüft, ob das XMLList-Objekt ein XML-Objekt enthält, das dem angegebenen value-Parameter entspricht.	XMLList
		copy():XMLList Gibt eine Kopie des gegebenen XMLList-Objekts zurück.	XMLList
		descendants(name:Object = *):XMLList Gibt alle untergeordneten Elemente (direkt untergeordnete und über mehrere Zweige hinweg untergeordnete Knoten) des XML-Objekts zurück, die dem gegebenen name-Parameter entsprechen.	XMLList
		elements(name:Object = *):XMLList Ruft die elements()-Methode jedes XML-Objekts auf.	XMLList
		hasComplexContent():Boolean Prüft, ob das XMLList-Objekt komplexen Inhalt enthält.	XMLList
		hasOwnProperty(p:String):Boolean Sucht nach der durch „p“ angegebenen Eigenschaft.	XMLList
		hasSimpleContent():Boolean Prüft, ob das XMLList-Objekt einfachen Inhalt enthält.	XMLList
		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
		length():int Gibt die Anzahl der Eigenschaften im XMLList-Objekt zurück.	XMLList
		normalize():XMLList Führt benachbarte Textknoten zusammen und entfernt leere Textknoten für alle Textknoten im XMLList-Objekt, alle XML-Objekte im XMLList-Objekt und die untergeordneten Elemente aller XML-Objekte im XMLList-Objekt.	XMLList
		parent():Object Gibt den übergeordneten Knoten des XMLList-Objekts zurück, wenn alle Elemente im XMLList-Objekt denselben übergeordneten Knoten besitzen.	XMLList
		processingInstructions(name:String = "*"):XMLList Wird ein name-Parameter bereitgestellt, werden alle untergeordneten Knoten des XMLList-Objekts aufgelistet, die Verarbeitungsanweisungen mit diesem Namen enthalten.	XMLList
		propertyIsEnumerable(p:String):Boolean Prüft, ob sich die Eigenschaft „p“ in dem Satz an Eigenschaften befindet, die in einer auf das XMLList-Objekt angewendeten „for..in“-Anweisung durchlaufen werden können.	XMLList
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		text():XMLList Ruft die text()-Methode für jedes XML-Objekt zurück und gibt ein XMLList-Objekt mit den Ergebnissen zurück.	XMLList
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt alle XML-Objekte in einem XMLList-Objekt als String zurück.	XMLList
		toXMLString():String Gibt alle XML-Objekte in einem XMLList-Objekt als String zurück.	XMLList
		valueOf():XMLList Gibt das XMLList-Objekt zurück.	XMLList

Konstruktordetails

()

Konstruktor

public function XMLList(value:Object)

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Erstellt ein neues XMLList-Objekt.

Parameter

value:Object — Jedes Objekt, das mithilfe von XMLList(), einer Funktion oberster Ebene, in ein XMLList-Objekt konvertieren werden kann.

Verwandte API-Elemente

XMLList()-Funktion auf oberster Ebene

Methodendetails

attribute

()

Methode

AS3 function attribute(attributeName:*):XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Ruft die attribute()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit den Ergebnissen zurück. Die Ergebnisse entsprechen dem angegebenen attributeName-Parameter. Wenn es keine Übereinstimmung gibt, gibt die attribute()-Methode ein leeres XMLList-Objekt zurück.

Parameter

attributeName:* — Der Name des Attributs, dass Sie in ein XMLList-Objekt einbinden wollen.

Rückgabewerte

XMLList — Ein XMLList-Objekt mit übereinstimmenden XML-Objekten oder ein leeres XMLList-Objekt.

Verwandte API-Elemente

XML.attribute()
XML.attributes()

attributes

()

Methode

AS3 function attributes():XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Ruft die attributes()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit Attributen für jedes XML-Objekt zurück.

Rückgabewerte

XMLList — Ein XMLList-Objekt mit Attributen für jedes XML-Objekt.

Verwandte API-Elemente

XML.attribute()
XML.attributes()

child

()

Methode

AS3 function child(propertyName:Object):XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Ruft die child()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt zurück, das die Ergebnisse in der richtigen Reihenfolge enthält.

Parameter

propertyName:Object — Der Elementname oder die Ganzzahl des untergeordneten XML-Elements.

Rückgabewerte

XMLList — Ein XMLList-Objekt mit untergeordneten Knoten, die dem input-Parameter entsprechen.

Verwandte API-Elemente

XML.child()

children

()

Methode

AS3 function children():XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Ruft die children()-Methode für jedes XML-Objekt zurück und gibt ein XMLList-Objekt mit den Ergebnissen zurück.

Rückgabewerte

XMLList — Ein XMLList-Objekt mit den Knoten, die dem XML-Objekt untergeordnet sind.

Verwandte API-Elemente

XML.children()

comments

()

Methode

AS3 function comments():XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Ruft die comments()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit Kommentaren zurück.

Rückgabewerte

XMLList — Ein XMLList-Objekt mit den Kommentaren im XML-Objekt.

Verwandte API-Elemente

XML.comments()

contains

()

Methode

AS3 function contains(value:XML):Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Prüft, ob das XMLList-Objekt ein XML-Objekt enthält, das dem angegebenen value-Parameter entspricht.

Parameter

value:XML — Ein XML-Objekt, das mit dem aktuellen XMLList-Objekt verglichen werden soll.

Rückgabewerte

Boolean — value, wenn das XMLList-Objekt das im Parameter true deklarierte XML-Objekt enthält; andernfalls false.

copy

()

Methode

AS3 function copy():XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Gibt eine Kopie des gegebenen XMLList-Objekts zurück. Die Kopie ist ein Duplikat der gesamten Knotenbaumstruktur. Das kopierte XML-Objekt hat kein übergeordnetes Objekt und gibt den Wert null zurück, wenn Sie versuchen, die parent()-Methode aufzurufen.

Rückgabewerte

XMLList — Eine Kopie des XMLList-Objekts.

descendants

()

Methode

AS3 function descendants(name:Object = *):XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Gibt alle untergeordneten Elemente (direkt untergeordnete und über mehrere Zweige hinweg untergeordnete Knoten) des XML-Objekts zurück, die dem gegebenen name-Parameter entsprechen. Der name-Parameter kann ein QName-Objekt sein, ein Objekt des Datentyps String oder jeglichen sonstigen Datentyps, der sich in einen String konvertieren lässt.

Um alle untergeordneten Elemente zurückzugeben, verwenden Sie den Sternparameter (*). Wird kein Parameter übergeben, wird der String „*“ übergeben, sodass alle untergeordneten Elemente des XML-Objekts zurückgegeben werden.

Parameter

name:Object (default = *) — Der Name des zu vergleichenden Elements.

Rückgabewerte

XMLList — Ein XMLList-Objekt der übereinstimmenden untergeordneten Elemente (direkt untergeordnete sowie über mehrere Zweige hinweg untergeordnete Knoten) des XML-Objekts in der ursprünglichen Liste. Wenn es keine untergeordneten Elemente gibt, wird ein leeres XMLList-Objekt zurückgegeben.

Verwandte API-Elemente

XML.descendants()

elements

()

Methode

AS3 function elements(name:Object = *):XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Ruft die elements()-Methode jedes XML-Objekts auf. Der Parameter name wird an die Methode descendants() übergeben. Wird kein Parameter übergeben, wird der String „*“ an die Methode descendants() übergeben.

Parameter

name:Object (default = *) — Der Name des zu vergleichenden Elements.

Rückgabewerte

XMLList — Ein XMLList-Objekt mit den übereinstimmenden untergeordneten Elementen im XML-Objekt.

Verwandte API-Elemente

XML.elements()

hasComplexContent

()

Methode

AS3 function hasComplexContent():Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Prüft, ob das XMLList-Objekt komplexen Inhalt enthält. Man betrachtet den Inhalt eines XMLList-Objekts als komplex, wenn es nicht leer ist oder eine der folgenden Bedingungen erfüllt ist:

Das XMLList-Objekt enthält ein einziges XML-Element mit komplexem Inhalt.
Das XMLList-Objekt enthält Elemente.

Rückgabewerte

Boolean — true, wenn das XMLList-Objekt einen komplexen Inhalt hat; andernfalls false.

Verwandte API-Elemente

hasSimpleContent()
XML.hasComplexContent()
XML.hasSimpleContent()

hasOwnProperty

()

Methode

AS3 function hasOwnProperty(p:String):Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Prüft nach der durch p angegebenen Eigenschaft.

Parameter

p:String — Die zu vergleichende Eigenschaft.

Rückgabewerte

Boolean — true, wenn der Parameter vorhanden ist; andernfalls false.

hasSimpleContent

()

Methode

AS3 function hasSimpleContent():Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Prüft, ob das XMLList-Objekt einfachen Inhalt enthält. Man betrachtet den Inhalt eines XMLList-Objekts als einfach, wenn eine oder mehrere der folgenden Bedingungen erfüllt sind:

Das XMLList-Objekt ist leer.
Das XMLList-Objekt enthält ein einziges XML-Element mit einfachem Inhalt.
Das XMLList-Objekt enthält keine Elemente.

Rückgabewerte

Boolean — true, wenn das XMLList-Objekt einen einfachen Inhalt hat; andernfalls false.

Verwandte API-Elemente

hasComplexContent()
XML.hasComplexContent()
XML.hasSimpleContent()

length

()

Methode

AS3 function length():int

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Gibt die Anzahl der Eigenschaften im XMLList-Objekt zurück.

Rückgabewerte

int — Die Anzahl der Eigenschaften im XMLList-Objekt.

normalize

()

Methode

AS3 function normalize():XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Führt benachbarte Textknoten zusammen und entfernt leere Textknoten für alle Textknoten im XMLList-Objekt, alle XML-Objekte im XMLList-Objekt und die untergeordneten Elemente aller XML-Objekte im XMLList-Objekt.

Rückgabewerte

XMLList — Das normalisierte XMLList-Objekt.

parent

()

Methode

AS3 function parent():Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Gibt den übergeordneten Knoten des XMLList-Objekts zurück, wenn alle Elemente im XMLList-Objekt denselben übergeordneten Knoten besitzen. Hat das XMLList-Objekt keine oder unterschiedliche übergeordnete Knoten, gibt die Methode den Wert undefined zurück.

Rückgabewerte

Object — Gibt das übergeordnete XML-Objekt zurück.

processingInstructions

()

Methode

AS3 function processingInstructions(name:String = "*"):XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Wird ein name-Parameter bereitgestellt, werden alle untergeordneten Knoten des XMLList-Objekts aufgelistet, die Verarbeitungsanweisungen mit diesem Namen enthalten. Ohne Parameter listet diese Methode alle untergeordneten Knoten des XMLList-Objekts auf, die irgendwelche Verarbeitungsanweisungen enthalten.

Parameter

name:String (default = "*") — Der Name der gesuchten Verarbeitungsanweisung.

Rückgabewerte

XMLList — Ein XMLList-Objekt, das die Verarbeitungsanweisungen für jedes XML-Objekt enthält.

Verwandte API-Elemente

XML.processingInstructions()

propertyIsEnumerable

()

Methode

AS3 function propertyIsEnumerable(p:String):Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Prüft, ob sich die Eigenschaft p in dem Satz an Eigenschaften befindet, die in einer auf das XML-Objekt angewendeten for..in-Anweisung durchlaufen werden können. Es ergibt sich der true, wenn toNumber(p) größer oder gleich 0 und kleiner als die Länge des XMLList-Objekts ist.

Parameter

p:String — Die Indexposition einer zu überprüfenden Eigenschaft.

Rückgabewerte

Boolean — Wenn die Eigenschaft in einer for..in-Anweisung durchlaufen werden kann, lautet der Wert true; andernfalls false.

text

()

Methode

AS3 function text():XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Ruft die text()-Methode für jedes XML-Objekt zurück und gibt ein XMLList-Objekt mit den Ergebnissen zurück.

Rückgabewerte

XMLList — Ein XMLList-Objekt mit allen XML-Eigenschaften des XMLList-Objekts, die XML-Textknoten darstellen.

Verwandte API-Elemente

XML.text()

toString

()

Methode

AS3 function toString():String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Gibt alle XML-Objekte in einem XMLList-Objekt als String zurück. Nach welchen Regeln diese Konvertierung vollzogen wird, ist abhängig davon, ob das XML-Objekt einen einfachen oder komplexen Inhalt hat:

Hat das XML-Objekt einen einfachen Inhalt, gibt toString() den String-Inhalt des XML-Objekts zurück, wobei das Start-Tag, vorhandene Attribute, Namespace-Deklarationen und das Endtag entfernt werden.

Hat das XML-Objekt einen komplexen Inhalt, gibt toString() das gesamte XML-Objekt als XML-kodierten String zurück, einschließlich Start-Tag, Attributen, Namespace-Deklarationen und End-Tag.

Damit jedes Mal das gesamte XML-Objekt zurückgegeben wird, verwenden Sie die Methode toXMLString().

Rückgabewerte

String — Die Stringdarstellung des XML-Objekts.

Verwandte API-Elemente

hasComplexContent()
hasSimpleContent()
toXMLString()

Beispiel ( Verwendung dieses Beispiels )

Im folgende Beispiel wird veranschaulicht, was die toString()-Methode zurückgibt, wenn das XML-Objekt einen einfachen Inhalt hat:

var test:XML = <type name="Joe">example</type>;
trace(test.toString()); //example

Im folgende Beispiel wird veranschaulicht, was die toString()-Methode zurückgibt, wenn das XML-Objekt einen komplexen Inhalt hat:

var test:XML = 
<type name="Joe">
    <base name="Bob"></base>
    example
</type>;
trace(test.toString());
  // <type name="Joe">
  // <base name="Bob"/>
  // example
  // </type>

toXMLString

()

Methode

AS3 function toXMLString():String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Gibt alle XML-Objekte in einem XMLList-Objekt als String zurück. Im Gegensatz zur Methode toString() gibt die Methode toXMLString() immer das Start-Tag, vorhandene Attribute und das End-Tag des XML-Objekts zurück, unabhängig davon, ob das XML-Objekt einen einfachen oder komplexen Inhalt hat. (Die Methode toString() entfernt alle diese Elemente für XML-Objekte mit einfachem Inhalt.)

Rückgabewerte

String — Die Stringdarstellung des XML-Objekts.

Verwandte API-Elemente

toString()

valueOf

()

Methode

AS3 function valueOf():XMLList

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9

Gibt das XMLList-Objekt zurück.

Rückgabewerte

XMLList — Gibt das aktuelle XMLList-Objekt zurück.

Beispiele Verwendung dieses Beispiels

XMLListExample.as

Im folgenden Beispiel wird eine XML-Eigenschaft namens books erstellt, und mehrere Elemente werden mitbook publisher und name-Tags zum Knoten books hinzugefügt. Anschließend wird die showBooksByPublisher()-Methode aufgerufen und auf die XMLList-Sammlung angewendet; jedes Element, das dem Herausgeber „Addison-Wesley“ entspricht, wird zurückgegeben.

package {
    import flash.display.Sprite;

    public class XMLListExample extends Sprite {
        private var books:XML;

        public function XMLListExample() {
            books =    <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>;

            showBooksByPublisher("Addison-Wesley");
        }

        private function showBooksByPublisher(name:String):void {
            var results:XMLList = books.book.(@publisher == name);
            showList(results);
        }

        private function showList(list:XMLList):void {
            var item:XML;
            for each(item in list) {
                trace("item: " + item.toXMLString());
            }
        }
    }
}

Rechtliche Hinweise | Onlinedatenschutzerklärung

XMLList - AS3

Klassen x

XMLList

attribute

attributes

child

children

comments

contains

copy

descendants

elements

hasComplexContent

hasOwnProperty

hasSimpleContent

length

normalize

parent

processingInstructions

propertyIsEnumerable

text

toString

toXMLString

valueOf