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 |
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.
Verwandte API-Elemente
Methode | Definiert von | ||
---|---|---|---|
Erstellt ein neues XMLList-Objekt. | XMLList | ||
Ruft die attribute()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit den Ergebnissen zurück. | 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 | ||
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 | ||
Ruft die children()-Methode für jedes XML-Objekt zurück und gibt ein XMLList-Objekt mit den Ergebnissen zurück. | XMLList | ||
Ruft die comments()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit Kommentaren zurück. | XMLList | ||
Prüft, ob das XMLList-Objekt ein XML-Objekt enthält, das dem angegebenen value-Parameter entspricht. | XMLList | ||
Gibt eine Kopie des gegebenen XMLList-Objekts zurück. | 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 | ||
Ruft die elements()-Methode jedes XML-Objekts auf. | XMLList | ||
Prüft, ob das XMLList-Objekt komplexen Inhalt enthält. | XMLList | ||
Sucht nach der durch „p“ angegebenen Eigenschaft. | XMLList | ||
Prüft, ob das XMLList-Objekt einfachen Inhalt enthält. | XMLList | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt die Anzahl der Eigenschaften im XMLList-Objekt zurück. | 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 | ||
Gibt den übergeordneten Knoten des XMLList-Objekts zurück, wenn alle Elemente im XMLList-Objekt denselben übergeordneten Knoten besitzen. | XMLList | ||
Wird ein name-Parameter bereitgestellt, werden alle untergeordneten Knoten des XMLList-Objekts aufgelistet, die Verarbeitungsanweisungen mit diesem Namen enthalten. | XMLList | ||
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 | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Ruft die text()-Methode für jedes XML-Objekt zurück und gibt ein XMLList-Objekt mit den Ergebnissen zurück. | XMLList | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt alle XML-Objekte in einem XMLList-Objekt als String zurück. | XMLList | ||
Gibt alle XML-Objekte in einem XMLList-Objekt als String zurück. | XMLList | ||
Gibt das XMLList-Objekt zurück. | XMLList |
XMLList | () | Konstruktor |
public function XMLList(value:Object)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Erstellt ein neues XMLList-Objekt.
Parametervalue:Object — Jedes Objekt, das mithilfe von XMLList() , einer Funktion oberster Ebene, in ein XMLList-Objekt konvertieren werden kann.
|
Verwandte API-Elemente
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.
|
XMLList — Ein XMLList-Objekt mit übereinstimmenden XML-Objekten oder ein leeres XMLList-Objekt.
|
Verwandte API-Elemente
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.
XMLList — Ein XMLList-Objekt mit Attributen für jedes XML-Objekt.
|
Verwandte API-Elemente
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.
|
XMLList — Ein XMLList-Objekt mit untergeordneten Knoten, die dem input-Parameter entsprechen.
|
Verwandte API-Elemente
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.
XMLList — Ein XMLList-Objekt mit den Knoten, die dem XML-Objekt untergeordnet sind.
|
Verwandte API-Elemente
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.
XMLList — Ein XMLList-Objekt mit den Kommentaren im XML-Objekt.
|
Verwandte API-Elemente
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.
|
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.
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.
|
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
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.
|
XMLList — Ein XMLList-Objekt mit den übereinstimmenden untergeordneten Elementen im XML-Objekt.
|
Verwandte API-Elemente
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.
Boolean — true , wenn das XMLList-Objekt einen komplexen Inhalt hat; andernfalls false .
|
Verwandte API-Elemente
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.
|
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.
Boolean — true , wenn das XMLList-Objekt einen einfachen Inhalt hat; andernfalls false .
|
Verwandte API-Elemente
length | () | Methode |
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ückgabewerteXMLList — 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.
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.
|
XMLList — Ein XMLList-Objekt, das die Verarbeitungsanweisungen für jedes XML-Objekt enthält.
|
Verwandte API-Elemente
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.
|
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.
XMLList — Ein XMLList-Objekt mit allen XML-Eigenschaften des XMLList-Objekts, die XML-Textknoten darstellen.
|
Verwandte API-Elemente
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()
.
String — Die Stringdarstellung des XML-Objekts.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
toString()
-Methode zurückgibt, wenn das XML-Objekt einen einfachen Inhalt hat:
var test:XML = <type name="Joe">example</type>; trace(test.toString()); //example
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.)
String — Die Stringdarstellung des XML-Objekts.
|
Verwandte API-Elemente
valueOf | () | Methode |
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()); } } } }
Tue Jun 12 2018, 10:04 AM Z