Renvoie le nombre d'octets de données disponibles pour la lecture dans le tampon de saisie. Votre code doit appeler la propriété bytesAvailable pour garantir que les données disponibles sont suffisantes, avant leur lecture à l’aide d’une des méthodes read.

Indique si l’objet URLStream est actuellement connecté. Un appel de cette propriété renvoie la valeur true si l'objet URLStream est connecté, false dans le cas contraire.

Indique l’ordre d’octet des données. Les valeurs possibles sont BIG_ENDIAN ou LITTLE_ENDIAN.

La valeur par défaut est Endian.BIG_ENDIAN.

Voir aussi

Contrôle la version du format AMF (Action Message Format) utilisé lors de l'écriture ou de la lecture d’un objet.

Voir aussi

Ferme immédiatement le flux continu et annule le téléchargement. Après l'appel de la méthode close(), aucune donnée ne peut être lue dans le flux continu.

Commence le téléchargement de l’URL spécifiée dans le paramètre request.

Remarque : si un fichier en cours de chargement contient des caractères non-ASCII (comme s'en trouvent dans de nombreuses langues autres que l'anglais), nous vous recommandons d'enregistrer le fichier en utilisant le codage UTF-8 ou UTF-16, plutôt que sous un format non-Unicode, ASCII par exemple.

Si le chargement échoue immédiatement, une exception IOError ou SecurityError (erreur de sécurité de fichier local comprise) décrivant l’échec est renvoyée. Dans le cas contraire, un événement open est distribué si le téléchargement de l’URL démarre correctement ou un événement d’erreur est distribué en cas d’erreur.

Pour utiliser cette méthode, tenez compte du modèle de sécurité d’Adobe^® Flash^® Player :

• Le chargement de données n'est pas autorisé si le fichier SWF appelant est dans le sandbox local avec système de fichiers et que la ressource cible provient d'un sandbox de réseau.
• Le chargement de données n'est pas autorisé si le fichier SWF appelant provient d'un sandbox de réseau et que la ressource cible est locale.
• Par défaut, l’URL que vous chargez doit se trouver dans exactement le même domaine que le fichier SWF appelant. Par exemple, un fichier SWF à l'adresse www.adobe.com peut charger uniquement des données provenant de sources situées aussi à l'adresse www.adobe.com. Pour charger des données à partir d'un autre domaine, placez un fichier de régulation interdomaines sur le serveur hébergeant les données.
• Vous pouvez empêcher un fichier SWF d'utiliser cette méthode en définissant le paramètre allowNetworking des balises object et embed dans la page HTML qui comporte le contenu SWF.

Pour plus d'informations, consultez les références suivantes :

• Le chapitre relatif à la sécurité du manuel Programmation d'ActionScript 3.0 et les derniers commentaires disponibles dans LiveDocs
• Le Livre blanc sur la sécurité de Flash Player 9

Paramètres

Voir aussi

Lit une valeur booléenne dans le flux continu. Un seul octet est lu, et la valeur true est renvoyée s'il n'est pas nul, false dans le cas contraire.

Lit un octet signé dans le flux continu.

La valeur renvoyée est comprise entre -128 et 127.

Lit le nombre d’octets de données spécifié par le paramètre length dans le flux. Les octets sont lus dans l’objet ByteArray spécifié par le paramètre bytes, à partir des octets offset dans l’objet ByteArray.

Paramètres

Lit un nombre à virgule flottante avec deux décimales, conforme à IEEE 754, dans le flux continu.

Lit un nombre à virgule flottante et à une décimale, conforme à IEEE 754, dans le flux continu.

Lit un entier signé de 32 bits dans le flux continu.

La valeur renvoyée est comprise entre -2147483648 et 2147483647.

Lit une chaîne à plusieurs octets de longueur spécifiée à partir du flux d'octets et à l'aide du jeu de caractères désigné.

Paramètres

Lit dans le socket un objet codé au format AMF (Action Message Format).

Voir aussi

Lit un entier signé de 16 bits dans le flux continu.

La valeur renvoyée est comprise entre -32768 et 32767.

Lit un octet non signé dans le flux continu.

La valeur renvoyée est comprise entre 0 et 255.

Lit un entier de 32 bits non signé dans le flux continu.

La valeur renvoyée est comprise entre 0 et 4294967295.

Lit un entier de 16 bits non signé dans le flux continu.

La valeur renvoyée est comprise entre 0 et 65535.

Lit une chaîne UTF-8 dans le flux continu. La chaîne doit être précédée d'un caractère non signé indiquant la longueur en octets.

Lit une séquence d'octets UTF-8 length dans le flux et renvoie une chaîne.

Paramètres

Distribué lorsque le chargement de données a abouti.

Les propriétés de cet événement sont les suivantes :

Distribué si un appel de la méthode URLStream.load() tente d'accéder à des données via HTTP et si l'environnement Flash Player actuel est capable de détecter et de renvoyer le code d'état de la requête. (Certains environnements de navigateur ne sont pas capables de fournir cette information.) Vous remarquerez que httpStatus (le cas échéant) sera envoyé avant (et en complément de) tout événement complete ou error.

Les propriétés de cet événement sont les suivantes :

Voir aussi

Distribué lorsqu'il se produit une erreur d'entrée/sortie entraînant l’échec d’un chargement.

Les propriétés de cet événement sont les suivantes :

Voir aussi

Distribué lors du démarrage d’une opération de chargement.

Les propriétés de cet événement sont les suivantes :

Voir aussi

Distribué à la réception des données au fur et à mesure du téléchargement. Les données reçues peuvent être lues immédiatement à l’aide des méthodes de la classe URLStream.

Les propriétés de cet événement sont les suivantes :

Voir aussi

Distribué si un appel de la méthode URLStream.load() tente de charger des données d'un serveur en dehors d'un sandbox de sécurité.

Les propriétés de cet événement sont les suivantes :

Voir aussi

Pour exécuter l’exemple, placez un fichier intitulé URLStreamExample.swf dans le même répertoire que vos fichiers SWF.

package {
    import flash.display.Sprite;
    import flash.errors.*;
    import flash.events.*;
    import flash.net.URLRequest;
    import flash.net.URLStream;

    public class URLStreamExample extends Sprite {
        private static const ZLIB_CODE:String = "CWS";
        private var stream:URLStream;

        public function URLStreamExample() {
            stream = new URLStream();
            var request:URLRequest = new URLRequest("URLStreamExample.swf");
            configureListeners(stream);
            try {
                stream.load(request);
            } catch (error:Error) {
                trace("Unable to load requested URL.");
            }
        }

        private function configureListeners(dispatcher:EventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function parseHeader():void {
            trace("parseHeader");
            trace("isCompressed: " + isCompressed());
            trace("version: " + stream.readByte());
        }

        private function isCompressed():Boolean {
            return (stream.readUTFBytes(3) == ZLIB_CODE);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
            parseHeader();
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:Event):void {
            trace("progressHandler: " + event);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}