U-X > XMLSocket.onXML

XMLSocket.onXML

Disponibilité

Flash Player 5.

Usage

monSocketXML.onXML(objet)

Paramètre

objet Une occurrence de l'objet XML contenant un document XML analysé reçu d'un serveur.

Renvoie

Rien.

Description

Méthode ; une fonction de rappel invoquée par Flash Player lorsque l'objet XML spécifié contenant un document XML arrive par une connexion XMLSocket ouverte. Une connexion XMLSocket peut être utilisée pour transférer un nombre illimité de documents XML entre le client et le serveur. Chaque document est terminé par un octet zéro. Lorsque Flash Player reçoit l'octet zéro, il analyse tout le code XML reçu depuis l'octet zéro précédent ou depuis que la connexion a été établie, s'il s'agit du premier message reçu. Chaque lot de code XML analysé est traité comme un seul document XML et transmis à la méthode onXML.

L'implémentation par défaut de cette méthode n'effectue aucune action. Pour annuler l'implémentation par défaut, vous devez affecter une fonction contenant vos propres actions.

Exemple

La fonction suivante prend la priorité sur l'implémentation par défaut de la méthode onXML dans une simple application de dialogue en ligne. La fonction myOnXML indique à l'application de dialogue en ligne de reconnaître un seul élément XML, MESSAGE, au format suivant :

<MESSAGE USER="John" TEXT="Bonjour, je m'appelle John!" />. 

Le gestionnaire onXML doit d'abord être installé dans l'objet XMLSocket de la façon suivante :

socket.onXML = myOnXML;

La fonction afficherMessage est considérée comme étant une fonction définie par l'utilisateur et qui affiche le message reçu par l'utilisateur.

function monOnXML(doc) {
	var e = doc.firstChild;
	if (e != null && e.nodeName == "MESSAGE") {
		afficherMessage(e.attributes.user, e.attributes.text);
	}
}

Voir aussi

function