PackageNiveau supérieur
Classepublic final dynamic class XMLList
HéritageXMLList Inheritance Object

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

Voir aussi

XML
for each..in
Namespace
QName


Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
Méthodes publiques
 MéthodeDéfini par
  
XMLList(value:Object)
Crée un objet XMLList.
XMLList
  
attribute(attributeName:*):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
  
child(propertyName:Object):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
  
elements(name:Object = *):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
 Inherited
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
 Inherited
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 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
Détails du constructeur
XMLList()Constructeur
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

Détails des méthodes
attribute()méthode
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

attributes()méthode 
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

child()méthode 
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

children()méthode 
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

comments()méthode 
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

contains()méthode 
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

copy()méthode 
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

descendants()méthode 
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

elements()méthode 
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

hasComplexContent()méthode 
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 :

Valeur renvoyée
Boolean — Renvoie true si l’objet XMLList intègre un contenu complexe, false dans le cas contraire.

Voir aussi

hasOwnProperty()méthode 
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

hasSimpleContent()méthode 
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 :

Valeur renvoyée
Boolean — Renvoie true si l’objet XMLList intègre un contenu simple, false dans le cas contraire.

Voir aussi

length()méthode 
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

normalize()méthode 
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

parent()méthode 
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

processingInstructions()méthode 
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

propertyIsEnumerable()méthode 
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

text()méthode 
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

toString()méthode 
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 :

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> 
toXMLString()méthode 
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

valueOf()méthode 
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

Exemples Utilisation des exemples
XMLListExample.as

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());
            }
        }
    }
}




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/XMLList.html