| 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
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| 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 = *) |
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 = *) |
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 = "*") |
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