U-X > XMLSocket.connect

XMLSocket.connect

Disponibilité

Flash Player 5.

Usage

monSocketXML.connect(hôte, port)

Paramètres

hôte Un nom de domaine DNS pleinement qualifié ou une adresse IP au format aaa.bbb.ccc.ddd. Vous pouvez également spécifier null pour établir une connexion au serveur hôte de l'animation.

port Le numéro de port TCP de l'hôte utilisé pour établir une connexion. Le numéro de port doit être supérieur ou égal à 1024.

Renvoie

Rien.

Description

Méthode ; établit une connexion avec l'hôte Internet spécifié en utilisant le port TCP spécifié (supérieur ou égal à 1024) et renvoie true ou false selon que la connexion a été établie ou non avec succès. Contactez l'administrateur de votre réseau si vous ne connaissez pas le numéro du port de votre machine hôte Internet. Si le module de Flash pour Netscape ou le contrôle ActiveX est utilisé, l'hôte spécifié dans le paramètre doit posséder le même sous-domaine que l'hôte d'où l'animation a été téléchargée.

Si vous spécifiez null pour le paramètre hôte, l'hôte contacté sera l'hôte de l'animation appelant XMLSocket.connect. Par exemple, si l'animation a été téléchargée depuis l'adresse http://www.monSite.fr, la spécification de null pour le paramètre d'hôte revient à entrer l'adresse IP de www.monSite.fr.

Si XMLSocket.connect renvoie la valeur true, la première étape du processus de connexion est un succès ; la méthode XMLSocket.onConnect est invoquée plus tard pour déterminer si la connexion finale a réussi ou échoué. Si XMLSocket.connect renvoie false, la connexion n'a pas pu être établie.

Exemple

L'exemple suivant utilise XMLSocket.connect pour établir une connexion à l'hôte de l'animation et utilise trace pour afficher la valeur renvoyée indiquant le succès ou l'échec de la connexion.

function maOnConnect(succès) {
	if (succès) {
		trace ("Réussite de la connexion !")
  } else {
		trace ("Echec de la connexion !")
	}
}
socket = new XMLSocket()
socket.onConnect = maOnConnect
if (!socket.connect(null, 2000)) {
	trace ("Echec de la connexion !")
}

Voir aussi

function, XMLSocket.onConnect