Guide de reference du langage ActionScript 2.0 - PowWeb

Cette méthode ouvre d'abord une boîte de dialogue d'un système d'exploitation demandant à
l'utilisateur d'entrer un nom de fichier et de sélectionner un emplacement sur l'ordinateur
local pour enregistrer le fichier. Quand l'utilisateur choisit un emplacement et confirme le
téléchargement (par ex. en cliquant sur Enregistrer), celui-ci commence sur le serveur distant.
Les écouteurs reçoivent des événements permettant d'indiquer la progression du
téléchargement, s'il a réussi ou échoué. Pour déterminer le statut de la boîte de dialogue et
l'opération de téléchargement après avoir appelé la méthode download(), votre code
ActionScript doit écouter les événements tels que onCancel, onOpen, onProgress, et
onComplete.
Une fois le fichier téléchargé, les propriétés de l'objet FileReference sont renseignées par les
propriétés du fichier local et l'écouteur onComplete est invoqué.
Une seule session browse() ou download() peut être effectuée à la fois (car une seule boîte de
dialogue peut être appelée à la fois).
Cette méthode prend en charge le téléchargement de tout type de fichier, via HTTP ou
HTTPS. Vous pouvez également envoyer des données au serveur avec l'appel de download()
en ajoutant des paramètres à l'URL pour que le script serveur les analyse.
Remarque : Si votre serveur requiert une authentification d'utilisateur, seuls les fichiers SWF
s'exécutant dans un navigateur, (c'est-à-dire utilisant le plug-in du navigateur ou le contrôle
ActiveX), peuvent fournir une boîte de dialogue pour demander à l'utilisateur un nom et un
mot de passe d'authentification, ceci uniquement pour les téléchargements. Concernant les
chargements effectués via le plug-in ou le contrôle ActiveX et le chargement/téléchargement
via les lecteurs autonomes ou externes, le transfert de fichiers échoue.
Pour utiliser cette méthode, tenez compte du modèle de sécurité de Flash Player :
■ Interdit si le fichier SWF appelant est dans une Sandbox locale non sûre.
■ Par défaut, l'accès est refusé entre Sandboxes. Un site web peut autoriser l'accès à une
ressource en ajoutant un fichier de régulation inter-domaines.
Pour plus d'informations, consultez les sections suivantes :
■ Chapitre 17, « Compréhension de la sécurité » dans Apprentissage d' ActionScript 2.0 dans
Flash
■ Le livre blanc sur la sécurité dans Flash Player 8
■ Le livre blanc sur la sécurité dans Flash Player 8 en liaison avec les API
Disponibilité : ActionScript 1.0 ; Flash Player 8
586 Chapitre 2: Classes ActionScript