AVURLLoader

Package	flash.media
Classe	public class AVURLLoader
Héritage	AVURLLoader URLLoader EventDispatcher Object

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

La classe URLLoader télécharge des données à partir d’une URL sous forme de texte, de données binaires ou de variables de code URL. Elle est utile pour télécharger des fichiers texte, XML ou d’autres informations destinées à être utilisées dans une application de données dynamique.

Un objet URLLoader télécharge toutes les données d’une URL avant de les mettre à disposition du code dans les applications. Il fournit des notifications sur la progression du téléchargement, que vous pouvez connaître en surveillant les propriétés bytesLoaded et bytesTotal, ainsi que les événements distribués.

Dans le cas de chargements de fichiers vidéo très volumineux, tels que des FLV, des erreurs de mémoire insuffisante peuvent se produire.

Lorsque vous employez cette classe dans Flash Player et dans le contenu de l’application AIR d’un sandbox de sécurité autre que celui de l’application, tenez compte du modèle de sécurité suivant :

Un fichier SWF du sandbox local avec système de fichiers risque de ne pas charger des données depuis une ressource située dans le sandbox réseau, ni lui en fournir.
Par défaut, le fichier SWF appelant et l’URL chargée doivent se trouver dans le même domaine. 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 d’URL sur le serveur hébergeant les données.

Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Adobe Flash Player : Sécurité (disponible en anglais uniquement).

Eléments de l’API associés

URLRequest
URLVariables
AVURLStream

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		bytesLoaded : uint = 0 Indique le nombre d’octets chargés jusqu’ici au cours du chargement.	URLLoader
		bytesTotal : uint = 0 Indique le nombre total d’octets dans les données téléchargées.	URLLoader
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		cookieHeader : String [écriture seule]	AVURLLoader
		data : * Données reçues par le biais de l’opération de chargement.	URLLoader
		dataFormat : String = "text" Contrôle si les données téléchargées sont reçues sous forme de texte (URLLoaderDataFormat.TEXT), de données binaires brutes (URLLoaderDataFormat.BINARY) ou de variables de code URL (URLLoaderDataFormat.VARIABLES).	URLLoader

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		AVURLLoader(request:URLRequest = null) Crée un objet URLLoader.	AVURLLoader
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override]	AVURLLoader
		close():void [override] Ferme l’opération de chargement en cours.	AVURLLoader
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		load(request:URLRequest):void [override] Envoie et charge les données à partir de l’URL spécifiée.	AVURLLoader
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	EventDispatcher

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
complete	Distribué après le décodage de toutes les données reçues et leur placement dans la propriété data de l’objet URLLoader.	AVURLLoader
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
httpResponseStatus	Distribué si un appel de la méthode load() tente d’accéder aux données via HTTP, et si Adobe AIR est capable de détecter et de renvoyer le code d’état de la requête.	AVURLLoader
httpStatus	Distribué si un appel de la méthode URLLoader.load() tente d’accéder aux données via HTTP.	AVURLLoader
ioError	Distribué si un appel de la méthode URLLoader.load() provoque une erreur fatale qui met fin au téléchargement.	AVURLLoader
open	Distribué lorsque l’opération de téléchargement commence suite à un appel de la méthode URLLoader.load().	AVURLLoader
progress	Distribué à la réception des données au fur et à mesure du téléchargement.	AVURLLoader
securityError	Distribué si un appel de la méthode URLLoader.load() tente de charger des données d’un serveur en dehors d’un sandbox de sécurité.	AVURLLoader

Détails de la propriété

cookieHeader

propriété

cookieHeader:String [écriture seule]

Implémentation
public function set cookieHeader(value:String):void

Détails du constructeur

()

Constructeur

public function AVURLLoader(request:URLRequest = null)

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Crée un objet URLLoader.

Paramètres

request:URLRequest (default = null) — Objet URLRequest indiquant l’URL à télécharger. Si ce paramètre n’est pas spécifié, aucune opération de chargement ne commence. S’il est spécifié, l’opération de chargement commence immédiatement (voir l’entrée load pour plus d’informations).

Eléments de l’API associés

URLLoader.load()

Détails de la méthode

addEventListener

()

méthode

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

Paramètres

	`type:String`

	`listener:Function`

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

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

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

close

()

méthode

override public function close():void

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Ferme l’opération de chargement en cours. Toute opération de chargement en cours prend immédiatement fin. Si aucune URL n’est en cours de transmission, une erreur de flux non valide est renvoyée.

load

()

méthode

override public function load(request:URLRequest):void

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Envoie et charge les données à partir de l’URL spécifiée. Les données peuvent être reçues sous forme de texte, de données binaires brutes ou de variables d’URL codées, selon la valeur définie pour la propriété dataFormat. Vous remarquerez que la valeur par défaut de la propriété dataFormat correspond à text. Si vous souhaitez envoyer des données à l’URL spécifiée, définissez la propriété data dans l’objet URLRequest.

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

Un fichier SWF du sandbox local avec système de fichiers risque de ne pas charger des données depuis une ressource située dans le sandbox réseau, ni lui en fournir.

Par défaut, le fichier SWF appelant et l’URL chargée doivent se trouver dans le même domaine. 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 d’URL sur le serveur hébergeant les données.

Vous ne pouvez pas vous connecter aux ports généralement réservés. Pour obtenir une liste complète des ports bloqués, voir la rubrique « Restriction des API de réseau » dans le Guide du développeur d’ActionScript 3.0.

Dans Flash Player versions 10 et ultérieures, si vous utilisez un Content-Type en plusieurs parties (par exemple « multipart/form-data ») qui contient un chargement (indiqué par un paramètre « filename » dans un en-tête « content-disposition » au sein du corps POST), l’opération POST est soumise aux règles de sécurité appliquées aux chargements :

L’opération POST doit être effectuée en réponse à l’action d’un utilisateur, comme un clic de souris ou la pression d’une touche.
Si l’opération POST se fait entre plusieurs domaines (la cible POST ne se trouve pas sur le même serveur que le fichier SWF qui envoie la demande POST), le serveur cible doit fournir un fichier de régulation d’URL qui permette l’accès interdomaines.

Par ailleurs, la syntaxe de tous les Content-Type en plusieurs parties doit être correcte (selon la norme RFC2046). Si la syntaxe s’avère incorrecte, l’opération POST est soumise aux règles de sécurité appliquées aux chargements.

Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).

Paramètres

request:URLRequest — Objet URLRequest indiquant l’URL à télécharger.

Evénements

	`complete:Event` — Distribué après le chargement effectif de données.

	`httpStatus:HTTPStatusEvent` — Si l’accès s’effectue via HTTP et que l’environnement Flash Player actuel permet l’obtention des codes d’état, il se peut que vous receviez ces événements en plus des événements `complete` ou `error`.

	`ioError:IOErrorEvent` — L’opération de chargement n’a pu se terminer.

	`progress:ProgressEvent` — Distribué à la réception des données au fur et à mesure du téléchargement.

	`securityError:SecurityErrorEvent` — Une opération de chargement a tenté d’extraire des données à partir d’un serveur situé en dehors du sandbox de sécurité de l’appelant. Vous pouvez contourner le problème en utilisant un fichier de régulation au niveau du serveur.

	`securityError:SecurityErrorEvent` — Une opération de chargement a tenté de charger un fichier SWZ (un composant de la plateforme Adobe), mais le certificat n’est pas valide ou le digest ne correspond pas au composant.

	`open:Event` — Distribué au commencement d’une opération de chargement.

	`httpResponseStatus:HTTPStatusEvent` — Distribué si un appel de la méthode `load()` tente d’accéder aux données via HTTP et si Adobe AIR est capable de détecter et de renvoyer le code d’état de la requête.

Valeur émise

	`ArgumentError` — Les objets `URLRequest.requestHeader` ne devraient pas contenir certains en-têtes de requête HTTP interdits. Pour plus d’informations, voir la description de la classe URLRequestHeader.

	`MemoryError` — Cette erreur peut se produire pour les raisons suivantes : 1) Flash Player ou Adobe AIR ne peut pas convertir le paramètre `URLRequest.data` du format UTF8 au format MBCS. Cette erreur est concernée si l’objet URLRequest transmis à la méthode `load()` est configuré pour exécuter une opération `GET` et si `System.useCodePage` est réglé sur `true`. 2) Flash Player ou Adobe AIR ne peut pas allouer de mémoire aux données `POST`. Cette erreur est concernée si l’objet URLRequest transmis à `load` est configuré pour exécuter une opération `POST`.

	`SecurityError` — Les fichiers non approuvés au niveau local ne peuvent pas communiquer avec Internet. Pour contourner ce problème, reclassifiez le fichier en tant que fichier local avec accès au réseau ou en tant que fichier approuvé.

	`SecurityError` — Si vous tentez de vous connecter à un port généralement réservé. Pour obtenir une liste complète des ports bloqués, voir la rubrique « Restriction des API de réseau » dans le Guide du développeur d’ActionScript 3.0.

	`TypeError` — La valeur du paramètre de requête ou de la propriété `URLRequest.url` de l’objet URLRequest transmis est `null`.

Eléments de l’API associés

URLRequestHeader
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest

Détails de l’événement

complete

Evénement

Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.COMPLETE

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Distribué après le décodage de toutes les données reçues et leur placement dans la propriété data de l’objet URLLoader. Il est possible d’accéder aux données reçues une fois cet événement distribué.

La constante Event.COMPLETE définit la valeur de la propriété type d’un objet événement complete.

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

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	Objet réseau dont le chargement est terminé.

Eléments de l’API associés

URLLoader.load()

httpResponseStatus

Evénement

Type d’objet d’événement: flash.events.HTTPStatusEvent
propriété HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, AIR 1.0, Flash Lite 4

Distribué si un appel de la méthode load() tente d’accéder aux données via HTTP, et si Adobe AIR est capable de détecter et de renvoyer le code d’état de la requête.

Contrairement à l’événement httpStatus, l’événement httpResponseStatus est renvoyé avant toute donnée de réponse. De plus, l’événement httpResponseStatus inclut des valeurs pour les propriétés responseHeaders et responseURL (qui ne sont pas définies pour un événement httpStatus. Notez que httpResponseStatus (le cas échéant) est envoyé avant (et en complément de) tout événement complete ou error.

La constante HTTPStatusEvent.HTTP_RESPONSE_STATUS définit la valeur de la propriété type d’un objet événement httpResponseStatus.

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

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`responseURL`	L’URL de laquelle la réponse a été renvoyée.
`responseHeaders`	Les en-têtes de réponse que la réponse a renvoyés, sous la forme d’un tableau d’objets URLRequestHeader.
`status`	Le code d’état HTTP renvoyé par le serveur.
`redirected`	Indique si la réponse est le résultat d’une redirection.
`target`	L’objet réseau recevant un code d’état HTTP.

Eléments de l’API associés

load()

httpStatus

Evénement

Type d’objet d’événement: flash.events.HTTPStatusEvent
propriété HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Distribué si un appel de la méthode URLLoader.load() tente d’accéder aux données via HTTP. Dans le cas de contenu s’exécutant dans Flash Player, cet événement n’est distribué que si l’environnement Flash Player actif 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 l’événement httpStatus (le cas échéant) est envoyé avant (et en complément de) tout événement complete ou error.

La constante HTTPStatusEvent.HTTP_STATUS définit la valeur de la propriété type d’un objet événement httpStatus.

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

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`status`	Le code d’état HTTP renvoyé par le serveur.
`target`	L’objet réseau recevant un code d’état HTTP.

Eléments de l’API associés

URLLoader.load()

ioError

Evénement

Type d’objet d’événement: flash.events.IOErrorEvent
propriété IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Distribué si un appel de la méthode URLLoader.load() provoque une erreur fatale qui met fin au téléchargement.

Définit la valeur de la propriété type d’un objet d’événement ioError.

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

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`errorID`	Un numéro de référence associé à l’erreur spécifique (AIR uniquement).
`target`	Objet réseau sur lequel l’erreur d’entrée/sortie s’est produite.
`text`	Texte à afficher en tant que message d’erreur.

Eléments de l’API associés

URLLoader.load()

open

Evénement

Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.OPEN

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Distribué lorsque l’opération de téléchargement commence suite à un appel de la méthode URLLoader.load().

La constante Event.OPEN définit la valeur de la propriété type d’un objet événement open.

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

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	Objet réseau qui a ouvert une connexion.

Eléments de l’API associés

URLLoader.load()

progress

Evénement

Type d’objet d’événement: flash.events.ProgressEvent
propriété ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Distribué à la réception des données au fur et à mesure du téléchargement.

Notez qu’avec un objet URLLoader, il est impossible d’accéder aux données avant la fin de leur téléchargement. L’événement progress indique donc uniquement la progression du téléchargement. Pour accéder aux données avant la fin du téléchargement, utilisez un objet AVURLStream.

Définit la valeur de la propriété type d’un objet événement progress.

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

Propriété	Valeur
`bubbles`	`false`
`bytesLoaded`	Nombre d’éléments ou d’octets chargés lors du traitement de l’événement par l’écouteur.
`bytesTotal`	Nombre total d’éléments ou d’octets qui seront chargés si le processus de chargement aboutit.
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	Objet indiquant la progression.

Eléments de l’API associés

URLLoader.load()

securityError

Evénement

Type d’objet d’événement: flash.events.SecurityErrorEvent
propriété SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Distribué si un appel de la méthode URLLoader.load() tente de charger des données d’un serveur en dehors d’un sandbox de sécurité. Egalement distribué si un appel de la méthode URLLoader.load() tente de charger un fichier SWZ, si le certificat n’est pas valide ou si la chaîne digest ne correspond pas au composant.

La constante SecurityErrorEvent.SECURITY_ERROR définit la valeur de la propriété type d’un objet événement securityError.

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

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	Objet réseau signalant l’erreur de sécurité
`text`	Texte à afficher en tant que message d’erreur.

Eléments de l’API associés

URLLoader.load()

Informations juridiques | Politique de confidentialité en ligne

AVURLLoader - AS3

Packagesx

Eléments du langage

Annexes

Package flash.media

cookieHeader

AVURLLoader

addEventListener

close

load

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError