| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
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
public function XMLList(value:Object)
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function attribute(attributeName:*):XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function attributes():XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function child(propertyName:Object):XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function children():XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function comments():XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function contains(value:XML):Boolean
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function copy():XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function descendants(name:Object = *):XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt alle Nachfahren (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 Nachfahren zurückzugeben, verwenden Sie den Sternparameter (*). Wird kein Parameter übergeben, wird der String "*" übergeben, sodass alle Nachfahren des XML-Objekts zurückgegeben werden.
Parameter
| name:Object (default = *) — Der Name des zu vergleichenden Elements.
|
Rückgabewerte
| XMLList — Ein XMLList-Objekt der übereinstimmenden Nachfahren (untergeordnete sowie über mehrere Zweige hinweg untergeordnete Knoten) des XML-Objekts in der ursprünglichen Liste. Wenn es keine Nachfahren gibt, wird ein leeres XMLList-Objekt zurückgegeben.
|
Siehe auch
AS3 function elements(name:Object = *):XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function hasComplexContent():Boolean
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function hasOwnProperty(p:String):Boolean
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function hasSimpleContent():Boolean
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function length():int
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die Anzahl der Eigenschaften im XMLList-Objekt zurück.
Rückgabewerte
| int — Die Anzahl der Eigenschaften im XMLList-Objekt.
|
Siehe auch
AS3 function normalize():XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Mischt benachbarte Textknoten und entfernt leere Textknoten für alle Textknoten im XMLList-Objekt, alle XML-Objekte im XMLList-Objekt und alle Nachfahren aller XML-Objekte im XMLList-Objekt.
Rückgabewerte
| XMLList — Das normalisierte XMLList-Objekt.
|
Siehe auch
AS3 function parent():Object
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function processingInstructions(name:String = "*"):XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function propertyIsEnumerable(p:String):Boolean
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
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. 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 — Der Index 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.
|
Siehe auch
AS3 function text():XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function toString():String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
Beispiel
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>
AS3 function toXMLString():String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | 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.
|
Siehe auch
AS3 function valueOf():XMLList
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt das XMLList-Objekt zurück.
Rückgabewerte
| XMLList — Gibt das aktuelle XMLList-Objekt zurück.
|
Siehe auch
Im folgenden Beispiel wird eine XML-Eigenschaft namens
books erstellt, und mehrere Elemente werden mit
book 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());
}
}
}
}
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Fri Oct 12 2007, 2:03 AM GMT-07:00
Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/XMLList.html