U-X > XML (objet)

XML (objet)

Utilisez les méthodes et propriétés de l'objet XML pour charger, analyser, envoyer, construire et manipuler des arborescences de documents XML. Dans Flash MX, l'objet XML est devenu un objet natif. Vous pourrez donc constater d'importantes améliorations des performances.

Vous devez utiliser le constructeur new XML() pour créer une occurrence de l'objet XML avant d'en appeler les méthodes.

XML est supporté par Flash Player 5 et Flash Player 6.

 
Méthodes de l'objet XML

Méthode	Description
XML.appendChild	Ajoute un nœud à la fin de la liste des enfants de l'objet spécifiée.
XML.cloneNode	Clone le nœud spécifié et, optionnellement, clone récursivement tous les enfants.
XML.createElement	Crée un élément XML.
XML.createTextNode	Crée un nœud texte XML.
XML.getBytesLoaded	Renvoie le nombre d'octets chargés pour le document XML spécifié.
XML.getBytesTotal	Renvoie la taille du document XML, en octets.
XML.hasChildNodes	Renvoie true si le nœud spécifié a des nœuds enfants ; sinon, renvoie false.
XML.insertBefore	Insère un nœud devant un nœud existant dans la liste des enfants du nœud spécifiée.
XML.load	Charge un document (spécifié par l'objet XML) depuis une URL.
XML.parseXML	Analyse un document XML dans l'arborescence de l'objet XML spécifiée.
XML.removeNode	Supprime le nœud spécifié de son parent.
XML.send	Envoie l'objet XML spécifié à une URL.
XML.sendAndLoad	Envoie l'objet XML spécifié à une URL et charge la réponse du serveur dans un autre objet XML.
XML.toString	Convertit le nœud spécifié et ses enfants en texte XML.

 
Propriétés de l'objet XML

Propriété	Description
XML.contentType	Indique le type MIME des données transmises au serveur.
XML.docTypeDecl	Définit et renvoie les informations relatives à la déclaration DOCTYPE d'un document XML.
XML.firstChild	Fait référence au premier enfant de la liste pour le nœud spécifié.
XML.ignoreWhite	Lorsque true, les nœuds de texte qui ne contiennent que des espaces vierges sont supprimés au cours de l'analyse.
XML.lastChild	Fait référence au dernier enfant de la liste pour le nœud spécifié.
XML.load	Vérifie si l'objet XML spécifié a été chargé.
XML.nextSibling	Fait référence au frère suivant dans la liste pour le nœud spécifié.
XML.nodeName	Renvoie le nom de balise d'un élément XML.
XML.nodeType	Renvoie le type du nœud spécifié (élément XML ou nœud de texte).
XML.nodeValue	Renvoie le texte du nœud spécifié si le nœud est un nœud texte.
XML.parentNode	Fait référence au nœud parent du nœud spécifié.
XML.previousSibling	Fait référence au frère précédent dans la liste pour le nœud spécifié.
XML.status	Renvoie un code d'état numérique indiquant le succès ou l'échec d'une opération d'analyse d'un document XML.
XML.xmlDecl	Définit et renvoie les informations relatives à une déclaration de document d'un document XML.

 
Collections de l'objet XML

Méthode	Description
XML.attributes	Renvoie un tableau associatif contenant tous les attributs du nœud spécifié.
XML.childNodes	Renvoie un tableau contenant les références aux nœuds enfants du nœud spécifié.

 
Gestionnaires d'événement de l'objet XML

Méthode	Description
XML.onData	Une fonction de rappel invoqué lorsque du texte XML a été complètement téléchargé du serveur ou lorsqu'une erreur se produit au cours de ce téléchargement.
XML.onLoad	Une fonction de rappel pour load et sendAndLoad.

 
Constructeur pour l'objet XML

Disponibilité

Flash Player 5.

Usage

new XML([source])

Paramètres

source Le texte XML analysé pour créer le nouvel objet XML.

Renvoie

Rien.

Description

Constructeur ; crée un nouvel objet XML. Vous devez utiliser la méthode constructeur pour créer une occurrence de l'objet XML avant d'en appeler les méthodes.

Remarque   Les méthodes createElement et createTextNode sont les méthodes « constructeur » pour la création d'éléments et de nœuds texte dans une arborescence de documents XML.

Exemple

Usage 1. L'exemple suivant crée un nouvel objet XML vide.

monCodeXML = new XML();

Usage 2. L'exemple suivant crée construit un objet XML en analysant le texte XML spécifié dans le paramètre source et remplit l'objet XML nouvellement créé avec l'arborescence XML résultante.

unAutreCodeXML = new XML("<pays>France<ville>Rennes</ville></pays>");

Voir aussi

XML.createElement, XML.createTextNode