U-X > XML.onData

XML.onData

Disponibilité

Flash Player 5

Usage

monCodeXML.onData()

Paramètres

Aucun.

Renvoie

Rien.

Description

Gestionnaire d'événement ; 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. Ce gestionnaire est invoqué avant l'analyse du code XML et, par conséquent, peut être utilisé pour appeler une routine d'analyse personnalisée au lieu d'utiliser le programme d'analyse XML de Flash. La méthode XML.onData renvoie soit la valeur undefined, soit une chaîne contenant du texte XML téléchargé à partir du serveur. Si la valeur renvoyée est undefined, une erreur a eu lieu pendant le téléchargement du XML à partir du serveur.

Par défaut, la méthode XML.onData invoque la méthode XML.onLoad. Vous pouvez annuler la méthode XML.onData en utilisant votre propre comportement, XML.onLoad n'étant plus appelé si vous n'appelez pas votre propre implémentation de XML.onData.

Exemple

L'exemple suivant montre à quoi ressemble la méthode onData par défaut :

XML.prototype.onData = function (src) {
  if (src == undefined) {
    this.onLoad(false);
  } else {
    this.parseXML(src);
    this.loaded = true;
    this.onLoad(true);
  }
}

La méthode XML.onData peut être supplantée pour intercepter le texte XML sans l'analyser.