Guide de reference du langage ActionScript 2.0 - PowWeb

connect (XMLSocket.connect, méthode)
public connect(url:String, port:Number) : Boolean
Etablit une connexion avec l'hôte Internet spécifié à l'aide du port TCP spécifié (doit être de
1024 ou plus), et renvoie true ou false,, en fonction de la connexion établie ou non. Si
vous ne connaissez pas le numéro de port de votre ordinateur hôte Internet, contactez votre
administrateur réseau.
Si vous spécifiez null pour le paramètre host, l'hôte contacté est celui où réside le fichier
SWF appelant XMLSocket.connect(). Par exemple, si le fichier SWF a été téléchargé à partir
du site www.yoursite.com, le fait de spécifier null pour le paramètre hôte équivaut à entrer
l'adresse IP pour www.yoursite.com.
Pour les fichiers SWF lus par une version antérieure à Flash Player 7, le paramètre host doit
correspondre au superdomaine du fichier SWF envoyant cet appel. Par exemple, un fichier
SWF à l'adresse www.someDomain.com peut charger des variables provenant d'un fichier
SWF à l'adresse store.someDomain.com, étant donné que les deux fichiers sont dans le même
superdomaine de someDomain.com.
Dans les fichiers SWF d'une version exécutée dans Flash Player 7 ou une version ultérieure, le
paramètre host doit se trouver exactement dans le même domaine. Par exemple, un fichier
SWF à l'adresse www.someDomain.com qui est publié pour Flash Player 5, mais s'exécute
dans Flash Player 7 ou une version ultérieure peut charger des variables uniquement à partir
de fichiers SWF qui sont également à l'adresse www.someDomain.com. Si vous souhaitez
charger des variables à partir d'un domaine différent, vous pouvez placer un fichier de
régulation interdomaines sur le serveur hébergeant le fichier SWF qui est utilisé.
Lorsque load() est exécuté, la propriété d'objet XML loadedest définie sur false. Lorsque
le téléchargement des données XML se termine, la propriété loaded est définie sur true et le
gestionnaire d'événements onLoad est appelé. Les données XML ne sont pas analysées avant la
fin du téléchargement. Si l'objet XML contenait précédemment des arborescences XML, elles
sont supprimées.
Si XMLSocket.connect() renvoie une valeur true, le niveau initial du processus de
connexion est accessible ; puis la méthode XMLSocket.onConnect est appelée pour
déterminer si la connexion finale a été établie ou non. Si XMLSocket.connect() renvoie
false, la connexion ne peut pas être établie.
Lorsque vous employez cette méthode, considérez le modèle de sécurité Flash Player.
■ Pour Flash Player 8, elle n'est pas autorisée si le fichier SWF appelant est le sandbox localwith-file-system.
■ Pour Flash Player 7 et postérieur, les sites Web permettent l'accès à des ressources, par des
demandeurs issus de différent domaines, via un fichier de régulation inter-domaines.
1388 Chapitre 2: Classes ActionScript