Restituisce il numero di byte dei dati disponibili per la lettura nel buffer di input. Il codice utente deve chiamare la proprietà bytesAvailable per verificare che i dati disponibili siano sufficienti prima di tentare di leggerli mediante uno dei metodi read.

Indica se l'oggetto URLStream è correntemente connesso. Una chiamata a questa proprietà restituisce un valore true se l'oggetto URLStream è connesso; false in caso contrario.

Indica l'ordine dei byte per i dati; i valori possibili sono BIG_ENDIAN o LITTLE_ENDIAN.

Il valore predefinito è Endian.BIG_ENDIAN.

Vedere anche

Controlla la versione di Action Message Format (AMF) utilizzata per scrivere o leggere un oggetto.

Vedere anche

Chiude immediatamente lo streaming e annulla l'operazione di scaricamento. Non è possibile leggere alcun dato dallo streaming dopo che è stato chiamato il metodo close().

Inizia a scaricare l'URL specificato nel parametro request.

Nota: se un file caricato contiene caratteri non ASCII (come accade in molte lingue diverse dall'inglese), si consiglia di salvare il file con una codifica UTF-8 o UTF-16, in contrapposizione a un formato non codificato con Unicode come ASCII.

Se l'operazione di caricamento locale non riesce immediatamente, viene generata un'eccezione IOError o SecurityError (compreso l'errore di sicurezza dei file locali) che descrive l'errore. Altrimenti, viene inviato un evento open se lo scaricamento dell'URL inizia correttamente, oppure viene inviato un evento di errore se si verifica un errore.

Quando si utilizza questo metodo, considerare il modello di sicurezza di Adobe^® Flash^® Player:

• Il caricamento dei dati non è consentito se il file SWF si trova nella sandbox locale con file system e la risorsa di destinazione si trova in una sandbox di rete.
• Il caricamento dei dati non è consentito nemmeno se il file SWF chiamante si trova in una sandbox di rete mentre la risorsa di destinazione è locale.
• Per impostazione predefinita, l'URL da caricare deve essere esattamente nello stesso dominio del file SWF che emette la chiamata. Ad esempio, un file SWF sul sito www.adobe.com può caricare i dati solo dalle origini presenti in www.adobe.com. Per caricare dati da un dominio diverso, collocare un file dei criteri dei domini sul server sul quale si trovano i dati.
• È possibile impedire che un file SWF utilizzi questo metodo impostando il parametro allowNetworking dei tag object ed embed nella pagina HTML che include il contenuto SWF.

Per ulteriori informazioni, vedere i seguenti riferimenti:

• Il capitolo Sicurezza di Flash Player nel volume Programmazione in ActionScript 3.0 e i commenti più recenti in LiveDocs
• Il White paper sulla sicurezza per Flash Player 9

Parametri

Vedere anche

Legge un valore booleano dallo streaming. Viene letto un singolo byte e viene restituito true se il byte è diverso da zero oppure false in caso contrario.

Legge un byte con segno dallo streaming.

Il valore restituito è compreso nell'intervallo -128...127.

Legge dallo streaming il numero di byte specificato dal parametro length. I byte vengono letti nell'oggetto ByteArray specificato da bytes, partendo dai byte offset nell'oggetto ByteArray.

Parametri

Legge un numero a virgola mobile e a precisione doppia IEEE 754 dallo streaming.

Legge un numero a virgola mobile e a precisione singola IEEE 754 dallo streaming.

Legge un numero intero a 32 bit con segno dallo streaming.

Il valore restituito è compreso nell'intervallo -2147483648...2147483647.

Legge una stringa multibyte della lunghezza specificata dal flusso di byte, utilizzando il set di caratteri specificato.

Parametri

Legge un oggetto dal socket, codificato in Action Message Format (AMF).

Vedere anche

Legge un numero intero a 16 bit con segno dallo streaming.

Il valore restituito è compreso nell'intervallo -32768...32767.

Legge un byte senza segno dallo streaming.

Il valore restituito è compreso nell'intervallo 0...255.

Legge un numero intero a 32 bit senza segno dallo streaming.

Il valore restituito è compreso nell'intervallo 0...4294967295.

Legge un numero intero a 16 bit senza segno dallo streaming.

Il valore restituito è compreso nell'intervallo 0...65535.

Legge una stringa UTF-8 dallo streaming. Si presume che la stringa abbia come prefisso una dichiarazione unsigned short, che indica la lunghezza in byte.

Legge dallo streaming una sequenza di byte UTF-8 pari al parametro length e restituisce una stringa.

Parametri

Inviato quando i dati sono stati caricati correttamente.

Questo evento ha le seguenti proprietà:

Inviato se una chiamata a URLStream.load() tenta di accedere ai dati via HTTP e l'ambiente Flash Player corrente è in grado di rilevare e restituire il codice di stato della richiesta. (Alcuni ambienti browser potrebbero non essere in grado di fornire queste informazioni). L'evento httpStatus (se presente) viene inviato prima di (e in aggiunta a) qualsiasi evento complete o error.

Questo evento ha le seguenti proprietà:

Vedere anche

Inviato quando si verifica un errore di input/output che impedisce l'operazione di caricamento.

Questo evento ha le seguenti proprietà:

Vedere anche

Inviato quando inizia un'operazione di caricamento.

Questo evento ha le seguenti proprietà:

Vedere anche

Inviato quando vengono ricevuti i dati mentre è in corso l'operazione di scaricamento. I dati che sono stati ricevuti possono essere letti immediatamente utilizzando i metodi della classe URLStream.

Questo evento ha le seguenti proprietà:

Vedere anche

Inviato se una chiamata al metodo URLStream.load() tenta di caricare dati da un server al di fuori della funzione di sicurezza sandbox.

Questo evento ha le seguenti proprietà:

Vedere anche

Per provare l'esempio, collocare un file di nome URLStreamExample.swf nella stessa directory del file 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);
        }
    }
}