| Package | Niveau supérieur |
| Classe | public final dynamic class XMLList |
| Héritage | XMLList  Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Plus d’exemples
Assemblage et transformation d’objets XML
Parcours de structures XML
Utilisation des espaces de noms XML
Conversion de type XML
Conversion d’objets XML et XMLList en chaînes
Lecture de documents XML externes
Utilisation de XML dans un exemple ActionScript : chargement de données RSS depuis Internet
Informations complémentaires
Principes de base de XML
Approche E4X concernant le traitement XML
Objets XML
Objets XMLList
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Méthode | Défini par | ||
|---|---|---|---|
Crée un objet XMLList. | XMLList | ||
Appelle la méthode attribute() de chaque objet XML et renvoie un objet XMLList contenant les résultats. | XMLList | ||
Appelle la méthode attributes() de chaque objet XML et renvoie un objet XMLList contenant les attributs de chaque objet XML. | XMLList | ||
Appelle la méthode child() de chaque objet XML et renvoie un objet XMLList contenant les résultats classés. | XMLList | ||
Appelle la méthode children() de chaque objet XML et renvoie un objet XMLList contenant les résultats. | XMLList | ||
Appelle la méthode comments() de chaque objet XML et renvoie un objet XMLList contenant des commentaires. | XMLList | ||
Vérifie si l’objet XMLList contient un objet XML égal au paramètre value spécifié. | XMLList | ||
Renvoie une copie de l’objet XMLList spécifié. | XMLList | ||
Renvoie tous les descendants (enfants, petits-enfants, arrière-petits-enfants, etc.) de l’objet XML associés au paramètre name indiqué. | XMLList | ||
Appelle la méthode elements() de chaque objet XML. | XMLList | ||
Vérifie si l’objet XMLList intègre un contenu complexe. | XMLList | ||
Recherche la propriété spécifiée par p. | XMLList | ||
Vérifie si l’objet XMLList intègre un contenu simple. | XMLList | ||
 |
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
Renvoie le nombre de propriétés de l’objet XMLList. | XMLList | ||
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. | XMLList | ||
Renvoie le parent de l’objet XMLList si tous les éléments intégrés à l’objet XMLList possèdent le même parent. | XMLList | ||
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é. | XMLList | ||
Vérifie si la propriété p figure 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. | XMLList | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
Appelle la méthode text() de chaque objet XML et renvoie un objet XMLList contenant les résultats. | XMLList | ||
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
Renvoie une représentation sous forme de chaîne de tous les objets XML intégrés à un objet XMLList. | XMLList | ||
Renvoie une représentation sous forme de chaîne de tous les objets XML intégrés à un objet XMLList. | XMLList | ||
Renvoie l’objet XMLList. | XMLList | ||
XMLList | () | Constructeur |
public function XMLList(value:Object)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Crée un objet XMLList.
Paramètresvalue:Object — Tout objet qui peut être converti en objet XMLList à l’aide de la fonction de niveau supérieur XMLList().
|
Eléments de l’API associés
attribute | () | méthode |
AS3 function attribute(attributeName:*):XMLList| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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.
|
XMLList — Objet XMLList composé d’objets XML correspondants ou vide.
|
Informations complémentaires
Eléments de l’API associés
attributes | () | méthode |
AS3 function attributes():XMLList| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Appelle la méthode attributes() de chaque objet XML et renvoie un objet XMLList contenant les attributs de chaque objet XML.
XMLList — Objet XMLList contenant les attributs de chaque objet XML.
|
Informations complémentaires
Eléments de l’API associés
child | () | méthode |
AS3 function child(propertyName:Object):XMLList| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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.
|
XMLList — Objet XMLList contenant les nœuds enfant qui correspondent au paramètre d’entrée.
|
Informations complémentaires
Eléments de l’API associés
children | () | méthode |
AS3 function children():XMLList| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Appelle la méthode children() de chaque objet XML et renvoie un objet XMLList contenant les résultats.
XMLList — Objet XMLList contenant les enfants des objets XML.
|
Informations complémentaires
Eléments de l’API associés
comments | () | méthode |
AS3 function comments():XMLList| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Appelle la méthode comments() de chaque objet XML et renvoie un objet XMLList contenant des commentaires.
XMLList — Objet XMLList contenant les commentaires associés aux objets XML.
|
Informations complémentaires
Eléments de l’API associés
contains | () | méthode |
AS3 function contains(value:XML):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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.
|
Boolean — Renvoie true si l’objet XMLList contient l’objet XML déclaré dans le paramètre value, false dans tous les autres cas.
|
Informations complémentaires
copy | () | méthode |
AS3 function copy():XMLList| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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().
XMLList — Copie de l’objet XMLList.
|
Informations complémentaires
descendants | () | méthode |
AS3 function descendants(name:Object = *):XMLList| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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 = *) |
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.
|
Informations complémentaires
Eléments de l’API associés
elements | () | méthode |
AS3 function elements(name:Object = *):XMLList| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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 = *) |
XMLList — Objet XMLList contenant les éléments enfant correspondants des objets XML.
|
Eléments de l’API associés
hasComplexContent | () | méthode |
AS3 function hasComplexContent():Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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.
Boolean — Renvoie true si l’objet XMLList intègre un contenu complexe, false dans le cas contraire.
|
Informations complémentaires
Eléments de l’API associés
hasOwnProperty | () | méthode |
AS3 function hasOwnProperty(p:String):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Recherche la propriété spécifiée par p.
Paramètres
p:String — Propriété pour laquelle établir une correspondance.
|
Boolean — Renvoie true si le paramètre existe, false dans le cas contraire.
|
Informations complémentaires
hasSimpleContent | () | méthode |
AS3 function hasSimpleContent():Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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.
Boolean — Renvoie true si l’objet XMLList intègre un contenu simple, false dans le cas contraire.
|
Informations complémentaires
Eléments de l’API associés
length | () | méthode |
normalize | () | méthode |
AS3 function normalize():XMLList| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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éeXMLList — L’objet XMLList normalisé.
|
Informations complémentaires
parent | () | méthode |
AS3 function parent():Object| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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.
Object — Renvoie l’objet XML parent.
|
Informations complémentaires
processingInstructions | () | méthode |
AS3 function processingInstructions(name:String = "*"):XMLList| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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 = "*") |
XMLList — Objet XMLList qui contient les instructions de traitement de chaque objet XML.
|
Informations complémentaires
Eléments de l’API associés
propertyIsEnumerable | () | méthode |
AS3 function propertyIsEnumerable(p:String):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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.
|
Boolean — Si la propriété peut faire l’objet d’une itération dans une instruction for..in, true ; sinon false.
|
Informations complémentaires
text | () | méthode |
AS3 function text():XMLList| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Appelle la méthode text() de chaque objet XML et renvoie un objet XMLList contenant les résultats.
XMLList — Objet XMLList contenant l’ensemble des propriétés XML de l’objet XMLList qui représentent les nœuds de texte XML.
|
Informations complémentaires
Eléments de l’API associés
toString | () | méthode |
AS3 function toString():String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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 noms 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 noms et la balise de fin.
Pour renvoyer à chaque fois l’objet XML entier, utilisez la méthode toXMLString().
String — Représentation sous forme de chaîne de l’objet XML.
|
Plus d’exemples
Informations complémentaires
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
toString() renvoie lorsque l’objet XML a un contenu simple :
var test:XML = <type name="Joe">example</type>; trace(test.toString()); //example
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>
toXMLString | () | méthode |
AS3 function toXMLString():String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, 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).
String — Représentation sous forme de chaîne de l’objet XML.
|
Plus d’exemples
Informations complémentaires
Eléments de l’API associés
valueOf | () | méthode |
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());
}
}
}
}
Tue Jun 12 2018, 09:30 AM Z