AVURLLoader

Pacchetto	flash.media
Classe	public class AVURLLoader
Ereditarietà	AVURLLoader URLLoader EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

La classe URLLoader scarica i dati da un URL sotto forma di testo, dati binari o variabili con codifica URL. Ciò è utile per scaricare file di testo, XML o altre informazioni da utilizzare in un'applicazione dinamica basata su dati.

Un oggetto URLLoader scarica tutti i dati da un URL prima di renderli disponibili per il codice nelle applicazioni. Invia delle notifiche relative all'avanzamento dello scaricamento, che è possibile monitorare mediante le proprietà bytesLoaded e bytesTotal, oltre che mediante gli eventi inviati.

Quando vengono caricati file video molto grandi, ad esempio file FLV, è possibile che vengano visualizzati errori di esaurimento della memoria.

Quando utilizzate questa classe in Flash Player e nel contenuto dell'applicazione AIR nelle funzioni di sicurezza sandbox diverse dalla funzione di sicurezza dell'applicazione, considerate il modello di sicurezza seguente:

Un file SWF che si trova nella sandbox locale con file system potrebbe non caricare dati da o fornire dati a una risorsa presente nella sandbox di rete.
Per impostazione predefinita, il file SWF chiamante e l'URL da caricare devono trovarsi esattamente nello stesso dominio. 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, collocate un file dei criteri degli URL sul server sul quale si trovano i dati.

Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player .

Elementi API correlati

URLRequest
URLVariables
AVURLStream

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		bytesLoaded : uint = 0 Indica il numero di byte che sono stati caricati fino a quel momento durante l'operazione di caricamento.	URLLoader
		bytesTotal : uint = 0 Indica il numero totale di byte dei dati scaricati.	URLLoader
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		cookieHeader : String [sola scrittura]	AVURLLoader
		data : * I dati ricevuti dall'operazione di caricamento.	URLLoader
		dataFormat : String = "text" Controlla se i dati scaricati vengono ricevuti sotto forma di testo (URLLoaderDataFormat.TEXT), dati binari originari (URLLoaderDataFormat.BINARY) o variabili con codifica URL (URLLoaderDataFormat.VARIABLES).	URLLoader

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		AVURLLoader(request:URLRequest = null) Crea un oggetto URLLoader.	AVURLLoader
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override]	AVURLLoader
		close():void [override] Chiude l'operazione di caricamento in corso.	AVURLLoader
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		load(request:URLRequest):void [override] Invia e carica i dati da un URL specificato.	AVURLLoader
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
complete	Inviato dopo che tutti i dati ricevuti sono stati decodificati e collocati nella proprietà data dell'oggetto URLLoader.	AVURLLoader
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher
httpResponseStatus	Inviato se una chiamata al metodo load() tenta di accedere ai dati via HTTP e Adobe AIR è in grado di rilevare e restituire il codice di stato della richiesta.	AVURLLoader
httpStatus	Inviato se una chiamata a URLLoader.load() tenta di accedere ai dati via HTTP.	AVURLLoader
ioError	Inviato se una chiamata a URLLoader.load() produce un errore irreversibile che interrompe lo scaricamento.	AVURLLoader
open	Inviato quando l'operazione di scaricamento inizia in seguito a una chiamata al metodo URLLoader.load().	AVURLLoader
progress	Inviato quando vengono ricevuti i dati mentre è in corso l'operazione di scaricamento.	AVURLLoader
securityError	Inviato se una chiamata al metodo URLLoader.load() tenta di caricare dati da un server al di fuori della funzione di sicurezza sandbox.	AVURLLoader

Descrizione delle proprietà

cookieHeader

proprietà

cookieHeader:String [sola scrittura]

Implementazione
public function set cookieHeader(value:String):void

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function AVURLLoader(request:URLRequest = null)

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea un oggetto URLLoader.

Parametri

request:URLRequest (default = null) — Un oggetto URLRequest che specifica l'URL da scaricare. Se questo parametro viene omesso, non inizia alcuna operazione di caricamento. Se specificato, l'operazione di caricamento inizia immediatamente (per ulteriori informazioni, vedete la voce load).

Elementi API correlati

URLLoader.load()

Descrizione dei metodi

addEventListener

()

metodo

override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Parametri

	`type:String`

	`listener:Function`

	`useCapture:Boolean` (default = `false`)

	`priority:int` (default = `0`)

	`useWeakReference:Boolean` (default = `false`)

close

()

metodo

override public function close():void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Chiude l'operazione di caricamento in corso. Tutte le operazioni di caricamento in corso vengono immediatamente terminate. Se al momento non è in corso lo streaming di un URL, viene generato un errore di streaming non valido.

load

()

metodo

override public function load(request:URLRequest):void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Invia e carica i dati da un URL specificato. I dati possono essere ricevuti sotto forma di testo, dati binari originari o variabili con codifica URL, a seconda del valore che è stato impostato per la proprietà dataFormat. Il valore predefinito per la proprietà dataFormat è text. Per inviare dati all'URL specificato, è possibile impostare la proprietà data nell'oggetto URLRequest.

Nota: se un file caricato contiene caratteri non ASCII come 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.

Un file SWF che si trova nella sandbox locale con file system potrebbe non caricare dati da o fornire dati a una risorsa presente nella sandbox di rete.

Per impostazione predefinita, il file SWF chiamante e l'URL da caricare devono trovarsi esattamente nello stesso dominio. 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, collocate un file dei criteri degli URL sul server sul quale si trovano i dati.

Non potete collegarvi alle porte comunemente riservate. Per un elenco completo di porte bloccate, vedete "Limitazioni delle API di connettività di rete" nella Guida per gli sviluppatori di ActionScript 3.0.

In Flash Player 10 e versioni successive, se utilizzate un Content-Type multipart (ad esempio "multipart/form-data") che contiene un caricamento (indicato da un parametro "filename" in un'intestazione "content-disposition" nel corpo POST), l'operazione POST è soggetta alle regole di sicurezza applicate ai caricamenti:

L'operazione POST deve essere eseguita come risposta a un'azione compiuta dall'utente, come un clic del mouse o la pressione di un tasto.
Se l'operazione POST è tra più domini (il target POST non si trova sullo stesso server del file SWF che invia la richiesta POST), il server di destinazione deve fornire un file di criteri URL che consenta l'accesso tra più domini.

Inoltre, per qualsiasi Content-Type multipart, la sintassi deve essere valida (in conformità agli standard RFC2046). Se la sintassi non è valida, l'operazione POST è soggetta alle regole di sicurezza applicate ai caricamenti.

Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player .

Parametri

request:URLRequest — Un oggetto URLRequest che specifica l'URL da scaricare.

Eventi

	`complete:Event` — Inviato dopo che i dati sono stati caricati correttamente.

	`httpStatus:HTTPStatusEvent` — Se l'accesso avviene via HTTP e l'ambiente Flash Player corrente supporta l'ottenimento di codici di stato, è possibile ricevere questi eventi in aggiunta agli eventi `complete` o `error`.

	`ioError:IOErrorEvent` — Impossibile completare l'operazione di caricamento.

	`progress:ProgressEvent` — Inviato quando vengono ricevuti i dati mentre è in corso l'operazione di scaricamento.

	`securityError:SecurityErrorEvent` — Un'operazione di caricamento ha tentato di recuperare dati da un server che si trova al di fuori della funzione di sicurezza sandbox del chiamante. Questo inconveniente può essere risolto utilizzando un file dei criteri sul server.

	`securityError:SecurityErrorEvent` — Un'operazione di caricamento ha tentato di caricare un file SWZ (un componente della piattaforma Adobe), ma il certificato non è valido o l'oggetto digest non corrisponde al componente.

	`open:Event` — Inviato quando inizia un'operazione di caricamento.

	`httpResponseStatus:HTTPStatusEvent` — Inviato se una chiamata al metodo `load()` tenta di accedere ai dati via HTTP e Adobe AIR è in grado di rilevare e restituire il codice di stato della richiesta.

Genera

	`ArgumentError` — Gli oggetti `URLRequest.requestHeader` potrebbero non contenere determinate intestazioni di richiesta HTTP proibite. Per ulteriori informazioni, vedete la descrizione della classe URLRequestHeader.

	`MemoryError` — Questo errore può verificarsi per i seguenti motivi: 1) Flash Player o AIR non è in grado di convertire il parametro `URLRequest.data` da UTF8 a MBCS. Questo errore è applicabile se l'oggetto URLRequest passato a `load()` è impostato per eseguire un'operazione `GET` e se `System.useCodePage` è impostato su `true`. 2) Flash Player o AIR non è in grado di allocare memoria per i dati `POST`. Questo errore è applicabile se l'oggetto URLRequest passato a `load` è impostato per eseguire un'operazione `POST`.

	`SecurityError` — I file non attendibili locali potrebbero non essere in grado di comunicare con Internet. Questo inconveniente può essere risolto riclassificando il file come file locale con utilizzo in rete o come attendibile.

	`SecurityError` — State tentando di collegarvi a una porta comunemente riservata. Per un elenco completo di porte bloccate, vedete "Limitazioni delle API di connettività di rete" nella Guida per gli sviluppatori di ActionScript 3.0.

	`TypeError` — Il valore del parametro request o della proprietà `URLRequest.url` dell'oggetto URLRequest passato è `null`.

Elementi API correlati

URLRequestHeader
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest

Descrizione degli eventi

complete

Evento

Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.COMPLETE

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Inviato dopo che tutti i dati ricevuti sono stati decodificati e collocati nella proprietà data dell'oggetto URLLoader. È possibile accedere ai dati ricevuti solo quando questo evento è stato inviato.

La costante Event.COMPLETE definisce il valore della proprietà type di un oggetto evento complete.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto di rete che ha completato il caricamento.

Elementi API correlati

URLLoader.load()

httpResponseStatus

Evento

Tipo di oggetto evento: flash.events.HTTPStatusEvent
proprietà HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, AIR 1.0, Flash Lite 4

Inviato se una chiamata al metodo load() tenta di accedere ai dati via HTTP e Adobe AIR è in grado di rilevare e restituire il codice di stato della richiesta.

A differenza dell'evento httpStatus, l'evento httpResponseStatus viene inviato prima dei dati di risposta. Inoltre, l'evento httpResponseStatus include valori per le proprietà responseHeaders e responseURL (che non sono definite per un evento httpStatus). L'evento httpResponseStatus (se presente) viene inviato prima di (e in aggiunta a) qualsiasi evento complete o error.

La costante HTTPStatusEvent.HTTP_RESPONSE_STATUS definisce il valore della proprietà type di un oggetto evento httpResponseStatus.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`responseURL`	L'URL da cui è stata restituita la risposta.
`responseHeaders`	Le intestazioni di risposta che la risposta ha restituito, come un array di oggetti URLRequestHeader.
`status`	Il codice di stato HTTP restituito dal server.
`redirected`	Se la risposta è il risultato di un reindirizzamento.
`target`	L'oggetto di rete che riceve un codice di stato HTTP.

Elementi API correlati

load()

httpStatus

Evento

Tipo di oggetto evento: flash.events.HTTPStatusEvent
proprietà HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Inviato se una chiamata a URLLoader.load() tenta di accedere ai dati via HTTP. Per il contenuto in esecuzione in Flash Player, questo evento viene inviato solo se l'ambiente Flash Player corrente è in grado di rilevare e restituire il codice di stato per la 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.

La costante HTTPStatusEvent.HTTP_STATUS definisce il valore della proprietà type di un oggetto evento httpStatus.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`status`	Il codice di stato HTTP restituito dal server.
`target`	L'oggetto di rete che riceve un codice di stato HTTP.

Elementi API correlati

URLLoader.load()

ioError

Evento

Tipo di oggetto evento: flash.events.IOErrorEvent
proprietà IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Inviato se una chiamata a URLLoader.load() produce un errore irreversibile che interrompe lo scaricamento.

Definisce il valore della proprietà type di un oggetto evento ioError.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`errorID`	Un numero di riferimento associato all'errore specifico (solo AIR).
`target`	L'oggetto di rete interessato dall'errore di input/output.
`text`	Testo da visualizzare come messaggio di errore.

Elementi API correlati

URLLoader.load()

open

Evento

Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.OPEN

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Inviato quando l'operazione di scaricamento inizia in seguito a una chiamata al metodo URLLoader.load().

La costante Event.OPEN definisce il valore della proprietà type di un oggetto evento open.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto di rete che ha aperto una connessione.

Elementi API correlati

URLLoader.load()

progress

Evento

Tipo di oggetto evento: flash.events.ProgressEvent
proprietà ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Inviato quando vengono ricevuti i dati mentre è in corso l'operazione di scaricamento.

Con un oggetto URLLoader non è possibile accedere ai dati fino a quando i dati non sono stati completamente ricevuti. Pertanto, l'evento di avanzamento funge solo da notifica dell'avanzamento dello scaricamento. Per accedere ai dati prima di averli completamente scaricati, utilizzate un oggetto AVURLStream.

Definisce il valore della proprietà type di un oggetto evento progress.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`bytesLoaded`	Il numero di elementi o di byte caricati nel momento in cui il listener elabora l'evento.
`bytesTotal`	Il numero totale di elementi o byte che vengono caricati se il processo di caricamento viene completato correttamente.
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto che riporta l'avanzamento.

Elementi API correlati

URLLoader.load()

securityError

Evento

Tipo di oggetto evento: flash.events.SecurityErrorEvent
proprietà SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Inviato se una chiamata al metodo URLLoader.load() tenta di caricare dati da un server al di fuori della funzione di sicurezza sandbox. Inviato anche se una chiamata a URLLoader.load() tenta di caricare un file SWZ e il certificato non è valido o la stringa digest non corrisponde al componente.

La costante SecurityErrorEvent.SECURITY_ERROR definisce il valore della proprietà type di un oggetto evento securityError.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto di rete che riporta l'errore di sicurezza.
`text`	Testo da visualizzare come messaggio di errore.

Elementi API correlati

URLLoader.load()

Note legali | Informativa sulla privacy online

AVURLLoader - AS3

Pacchettix

Elementi del linguaggio

Appendici

Pacchetto flash.media

cookieHeader

AVURLLoader

addEventListener

close

load

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError