| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
La classe XMLList contient des méthodes qui permettent de traiter au moins un élément XML. Un objet XMLList peut représenter au moins un objet ou un élément XML (ce qui inclut les nœuds multiples ou les attributs), de façon à pouvoir appeler des méthodes sur les éléments en tant que groupe ou sur les différents éléments de la collection.
Si un objet XMLList ne comporte qu'un seul élément XML, vous pouvez utiliser les méthodes de classe XML directement sur l'objet XMLList. Dans l’exemple suivant, example.two est un objet XMLList de longueur 1. Vous pouvez donc lui appliquer toute méthode XML.
var example2 = <example><two>2</two></example>;
Si vous tentez d'utiliser des méthodes de classe XML avec un objet XMLList contenant plusieurs objets XML, une exception est renvoyée. Vous pouvez par contre, effectuer une itération sur la collection XMLList (à l'aide d'une instruction for each..in, par exemple) et appliquer les méthodes aux différents objets XML de la collection.
Consulter les exemples
public function XMLList(value:Object)
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Crée un objet XMLList.
Paramètres
| value:Object — Tout objet qui peut être converti en objet XMLList à l’aide de la fonction de niveau supérieur XMLList().
|
Voir aussi
AS3 function attribute(attributeName:*):XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Appelle la méthode attribute() de chaque objet XML et renvoie un objet XMLList contenant les résultats. Les résultats correspondent au paramètre attributeName spécifié. Si aucune correspondance n’est détectée, la méthode attribute() renvoie un objet XMLList vide.
Paramètres
| attributeName:* — Nom de l’attribut à inclure dans un objet XMLList.
|
Valeur renvoyée
| XMLList — Objet XMLList composé d’objets XML correspondants ou vide.
|
Voir aussi
AS3 function attributes():XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Appelle la méthode attributes() de chaque objet XML et renvoie un objet XMLList contenant les attributs de chaque objet XML.
Valeur renvoyée
| XMLList — Objet XMLList contenant les attributs de chaque objet XML.
|
Voir aussi
AS3 function child(propertyName:Object):XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Appelle la méthode child() de chaque objet XML et renvoie un objet XMLList contenant les résultats classés.
Paramètres
| propertyName:Object — Nom de l’élément ou entier de l’objet XML enfant.
|
Valeur renvoyée
| XMLList — Objet XMLList contenant les nœuds enfant qui correspondent au paramètre d’entrée.
|
Voir aussi
AS3 function children():XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Appelle la méthode children() de chaque objet XML et renvoie un objet XMLList contenant les résultats.
Valeur renvoyée
| XMLList — Objet XMLList contenant les enfants des objets XML.
|
Voir aussi
AS3 function comments():XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Appelle la méthode comments() de chaque objet XML et renvoie un objet XMLList contenant des commentaires.
Valeur renvoyée
| XMLList — Objet XMLList contenant les commentaires associés aux objets XML.
|
Voir aussi
AS3 function contains(value:XML):Boolean
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Vérifie si l’objet XMLList contient un objet XML égal au paramètre value spécifié.
Paramètres
| value:XML — Objet XML à comparer à l'objet XMLList en cours.
|
Valeur renvoyée
| Boolean — Renvoie true si l’objet XMLList contient l’objet XML déclaré dans le paramètre value, false dans tous les autres cas.
|
Voir aussi
AS3 function copy():XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Renvoie une copie de l’objet XMLList spécifié. Cette copie est une duplication de l’arborescence entière de nœuds. L’objet XML copié ne possède pas de parent et renvoie null si vous tentez d’appeler la méthode parent().
Valeur renvoyée
| XMLList — Copie de l'objet XMLList.
|
Voir aussi
AS3 function descendants(name:Object = *):XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Renvoie tous les descendants (enfants, petits-enfants, arrière-petits-enfants, etc.) de l’objet XML associés au paramètre name indiqué. Le paramètre name peut être un objet QName, un type de données String ou tout autre type de données converti ensuite au type de données String.
Pour renvoyer tous les descendants, utilisez le paramètre astérisque (*). Si aucun paramètre n’est transmis, la chaîne « * » est transmise et renvoie tous les descendants de l’objet XML.
Paramètres
| name:Object (default = *) — Nom de l’élément pour lequel établir une correspondance.
|
Valeur renvoyée
| XMLList — Objet XMLList contenant les descendants (enfants, petits-enfants, etc.) correspondants des objets XML spécifiés dans la liste d’origine. S’il n’existe pas de descendants, la méthode renvoie un objet XMLList vide.
|
Voir aussi
AS3 function elements(name:Object = *):XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Appelle la méthode elements() de chaque objet XML. Le paramètre name est transmis à la méthode descendants(). Si aucun paramètre n’est transmis, la chaîne « * » est transmise à la méthode descendants().
Paramètres
| name:Object (default = *) — Nom des éléments pour lesquels établir une correspondance.
|
Valeur renvoyée
| XMLList — Objet XMLList contenant les éléments enfant correspondants des objets XML.
|
Voir aussi
AS3 function hasComplexContent():Boolean
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Vérifie si l’objet XMLList intègre un contenu complexe. Un objet XMLList est considéré comme complexe s’il n’est pas vide et que l’une des deux conditions suivantes est remplie :
- L’objet XMLList contient un élément XML unique au contenu complexe.
- L’objet XMLList contient des éléments.
Valeur renvoyée
| Boolean — Renvoie true si l’objet XMLList intègre un contenu complexe, false dans le cas contraire.
|
Voir aussi
AS3 function hasOwnProperty(p:String):Boolean
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Recherche la propriété spécifiée par p.
Paramètres
| p:String — Propriété pour laquelle établir une correspondance.
|
Valeur renvoyée
| Boolean — Renvoie true si le paramètre existe, false dans le cas contraire.
|
Voir aussi
AS3 function hasSimpleContent():Boolean
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Vérifie si l’objet XMLList intègre un contenu simple. Un objet XMLList est considéré comme simple si une ou plusieurs des conditions ci-dessous sont remplies :
- L’objet XMLList est vide.
- L’objet XMLList contient un élément XML unique au contenu simple.
- L’objet XMLList ne contient pas d’élément.
Valeur renvoyée
| Boolean — Renvoie true si l’objet XMLList intègre un contenu simple, false dans le cas contraire.
|
Voir aussi
AS3 function length():int
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Renvoie le nombre de propriétés de l’objet XMLList.
Valeur renvoyée
| int — Nombre de propriétés de l’objet XMLList.
|
Voir aussi
AS3 function normalize():XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Fusionne les nœuds de texte adjacents et élimine les nœuds de texte vides pour les éléments suivants : tous les nœuds de texte XMLList, tous les objets XML contenus dans XMLList et les descendants de tous les objets XML dans XMLList.
Valeur renvoyée
| XMLList — L’objet XMLList normalisé.
|
Voir aussi
AS3 function parent():Object
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Renvoie le parent de l’objet XMLList si tous les éléments intégrés à l’objet XMLList possèdent le même parent. Si l’objet XMLList ne possède pas de parent ou a des parents différents, la méthode renvoie undefined.
Valeur renvoyée
| Object — Renvoie l’objet XML parent.
|
Voir aussi
AS3 function processingInstructions(name:String = "*"):XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Si un paramètre name est spécifié, la méthode recense tous les enfants de l’objet XMLList qui contiennent des instructions de traitement portant le nom indiqué. Si aucun paramètre n’est spécifié, elle recense tous les enfants de l’objet XMLList qui contiennent des instructions de traitement.
Paramètres
| name:String (default = "*") — Nom des instructions de traitement pour lesquelles établir une correspondance.
|
Valeur renvoyée
| XMLList — Objet XMLList qui contient les instructions de traitement de chaque objet XML.
|
Voir aussi
AS3 function propertyIsEnumerable(p:String):Boolean
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Vérifie si la propriété p figurre dans le jeu de propriétés qui peut faire l'objet d'une itération avec une instruction for..in appliquée à l'objet XMLList. La valeur true n’est renvoyée que si toNumber(p) est supérieur ou égal à 0 et inférieur à la longueur de l’objet XMLList.
Paramètres
| p:String — Index d’une propriété à vérifier.
|
Valeur renvoyée
| Boolean — Si la propriété peut faire l'objet d'une itération dans une instruction for..in, true ; sinon false.
|
Voir aussi
AS3 function text():XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Appelle la méthode text() de chaque objet XML et renvoie un objet XMLList contenant les résultats.
Valeur renvoyée
| XMLList — Objet XMLList contenant l’ensemble des propriétés XML de l’objet XMLList qui représentent les nœuds de texte XML.
|
Voir aussi
AS3 function toString():String
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Renvoie une représentation sous forme de chaîne de tous les objets XML intégrés à un objet XMLList. Les règles de cette conversion varient selon que l’objet XML intègre un contenu simple ou complexe :
- Si l'objet XML comporte un contenu simple,
toString() renvoie le contenu de la chaîne de l'objet XML en éliminant les éléments suivants : la balise initiale, les attributs, les déclarations d'espace de nom et la balise de fin.
- Si l’objet XML intègre un contenu complexe,
toString() renvoie une chaîne codée au format XML qui représente l’objet XML entier, y compris la balise de début, les attributs, les déclarations d’espace de nom et la balise de fin.
Pour renvoyer à chaque fois l’objet XML entier, utilisez la méthode toXMLString().
Valeur renvoyée
| String — Représentation sous forme de chaîne de l’objet XML.
|
Voir aussi
Exemple
L'exemple suivant indique ce que la méthode
toString() renvoie lorsque l'objet XML a un contenu simple :
var test:XML = <type name="Joe">example</type>;
trace(test.toString()); //example
L'exemple suivant indique ce que la méthode
toString() renvoie lorsque l'objet XML a un contenu complexe :
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
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Renvoie une représentation sous forme de chaîne de tous les objets XML intégrés à un objet XMLList. A l’encontre de la méthode toString(), la méthode toXMLString() renvoie toujours la balise de début, les attributs et la balise de fin de l’objet XML, que son contenu soit simple ou complexe. (La méthode toString() supprime ces éléments si l’objet XML intègre un contenu simple.)
Valeur renvoyée
| String — Représentation sous forme de chaîne de l’objet XML.
|
Voir aussi
AS3 function valueOf():XMLList
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Renvoie l'objet XMLList.
Valeur renvoyée
| XMLList — Renvoie l'objet XMLList en cours.
|
Voir aussi
L'exemple suivant crée une propriété XML appelée
books et ajoute plusieurs éléments avec des balises
book publisher et
name à un nœud appelé
books. Ensuite, la méthode
showBooksByPublisher() est appelée, ce qui prend XMLList et renvoie tous les éléments qui correspondent à l'éditeur, « Addison-Wesley ».
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. Tous droits réservés.
Fri Oct 12 2007, 2:53 AM GMT-07:00
Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/XMLList.html