AVURLLoader

Paquete	flash.media
Clase	public class AVURLLoader
Herencia	AVURLLoader URLLoader EventDispatcher Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

La clase URLLoader descarga datos desde una URL como texto, datos binarios o variables con codificación URL. Resulta útil para descargar archivos de texto, XML o cualquier otra información que se utilice en una aplicación dinámica gestionada por datos.

Un objeto URLLoader descarga todos los datos de una URL antes de ponerla a disposición en el código de las aplicaciones. Envía notificaciones sobre el progreso de la descarga que se pueden supervisar mediante las propiedades bytesLoaded y bytesTotal, así como a través de los eventos distribuidos.

Al cargar archivos de vídeo de gran tamaño como, por ejemplo, archivos FLV, se pueden producir errores de memoria insuficiente.

Al utilizar esta clase en Flash Player y en el contenido de la aplicación de AIR en entornos limitados de seguridad distintos al entorno limitado de seguridad de la aplicación, se considera el modelo de seguridad siguiente:

Es posible que un archivo SWF del entorno limitado local-con-sistema-de-archivos no cargue ni proporcione datos a un recurso que se encuentre en el entorno limitado de red.
De forma predeterminada, el archivo SWF que realiza la llamada y la URL que se carga deben estar exactamente en el mismo dominio. Por ejemplo, un archivo SWF de www.adobe.com puede cargar datos únicamente de orígenes que también estén en www.adobe.com. Para cargar datos desde un dominio distinto, coloque un archivo de política URL en el servidor que aloja los datos.

Para obtener más información, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

Elementos de API relacionados

URLRequest
URLVariables
AVURLStream

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		bytesLoaded : uint = 0 Indica el número de bytes cargados hasta ese momento durante la operación de carga.	URLLoader
		bytesTotal : uint = 0 Indica el número total de bytes de los datos descargados.	URLLoader
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		cookieHeader : String [solo escritura]	AVURLLoader
		data : * Los datos recibidos de la operación de carga.	URLLoader
		dataFormat : String = "text" Controla si los datos cargados se reciben como texto (URLLoaderDataFormat.TEXT), como datos binarios sin formato (URLLoaderDataFormat.BINARY) o como variables con codificación URL (URLLoaderDataFormat.VARIABLES).	URLLoader

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		AVURLLoader(request:URLRequest = null) Crea un objeto URLLoader.	AVURLLoader
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override]	AVURLLoader
		close():void [override] Cierra la operación de carga en curso.	AVURLLoader
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		hasEventListener(type:String):Boolean Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		load(request:URLRequest):void [override] Envía y carga datos desde la URL especificada.	AVURLLoader
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object
		willTrigger(type:String):Boolean Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.	EventDispatcher

Eventos

Haga clic para obtener más información sobre los eventos

Ocultar eventos heredados

Mostrar eventos heredados

	Resumen	Definido por
activate	[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.	EventDispatcher
complete	Se distribuye tras decodificar y colocar todos los datos recibidos en la propiedad data del objeto URLLoader.	AVURLLoader
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher
httpResponseStatus	Se distribuye si una llamada al método load() intenta acceder a los datos mediante HTTP y Adobe AIR puede detectar y devolver el código de estado de la petición.	AVURLLoader
httpStatus	Se distribuye si una llamada al método URLLoader.load() intenta acceder a los datos mediante HTTP.	AVURLLoader
ioError	Se distribuye si el resultado de una llamada a URLLoader.load() es un error grave que hace que la descarga finalice.	AVURLLoader
open	Se distribuye cuando se inicia la operación de descarga tras una llamada al método URLLoader.load().	AVURLLoader
progress	Se distribuye al recibirse datos mientras progresa una operación de descarga.	AVURLLoader
securityError	Se distribuye si se intenta llamar a URLLoader.load() para cargar datos de un servidor situado fuera del entorno limitado de seguridad.	AVURLLoader

Información sobre propiedades

cookieHeader

propiedad

cookieHeader:String [solo escritura]

Implementación
public function set cookieHeader(value:String):void

Información sobre constructores

()

Información sobre

public function AVURLLoader(request:URLRequest = null)

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea un objeto URLLoader.

Parámetros

request:URLRequest (default = null) — Un objeto URLRequest que especifica la URL que se va a descargar. Si se omite este parámetro, no se inicia ninguna operación de carga. Si se especifica, la operación de carga se inicia inmediatamente (consulte la entrada load para obtener más información).

Elementos de API relacionados

URLLoader.load()

Información sobre métodos

addEventListener

()

método

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

Parámetros

	`type:String`

	`listener:Function`

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

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

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

close

()

método

override public function close():void

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Cierra la operación de carga en curso. Se detendrá inmediatamente cualquier operación de carga en curso. Si no se transmite ninguna URL en ese momento, se emitirá un error de transmisión no válida.

load

()

método

override public function load(request:URLRequest):void

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Envía y carga datos desde la URL especificada. Los datos se pueden recibir como texto, como datos binarios sin formato o como variables con codificación, en función del valor establecido para la propiedad dataFormat. Tenga en cuenta que el valor predeterminado de la propiedad dataFormat es text. Si quiere enviar datos a la URL especificada, puede establecer la propiedad data en el objeto URLRequest.

Nota: si un archivo que se está cargando contiene caracteres no ASCII (como ocurre en muchos idiomas, no así en inglés), se recomienda que guarde el archivo con codificación UTF-8 o UTF-16, en lugar de utilizar un formato no Unicode, como ASCII.

Es posible que un archivo SWF del entorno limitado local-con-sistema-de-archivos no cargue ni proporcione datos a un recurso que se encuentre en el entorno limitado de red.

De forma predeterminada, el archivo SWF que realiza la llamada y la URL que se carga deben estar exactamente en el mismo dominio. Por ejemplo, un archivo SWF de www.adobe.com puede cargar datos únicamente de orígenes que también estén en www.adobe.com. Para cargar datos desde un dominio distinto, coloque un archivo de política URL en el servidor que aloja los datos.

No es posible conectar con puertos reservados comúnmente. Para obtener una lista completa de los puertos bloqueados, consulte la sección “Restricción de API de red” en el Guía del desarrollador de ActionScript 3.0.

En Flash Player 10 y versiones posteriores, si utiliza una estructura Content-Type de varias partes (por ejemplo, "multipart/form-data") con una acción de carga (indicada por un parámetro "filename" en un encabezado "content-disposition" dentro del cuerpo POST), la operación POST está sujeta a las reglas de seguridad aplicadas a las cargas:

Es preciso realizar una operación POST como respuesta a una acción iniciada por el usuario, por ejemplo, un clic de ratón o la pulsación de una tecla.
Si la operación POST afecta a varios dominios (el destino POST no se encuentra en el mismo servidor que el archivo SWF que envía la petición POST), el servidor de destino debe proporcionar un archivo de política URL que permita el acceso a varios dominios.

Asimismo, en cualquier estructura Content-Type de varias partes, la sintaxis debe ser válida (de acuerdo con la norma RFC2046). Si la sintaxis no es válida, la operación POST está sujeta a las reglas de seguridad que se aplican a las cargas.

Para obtener más información, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

Parámetros

request:URLRequest — Un objeto URLRequest que especifica la URL que se va a descargar.

Eventos

	`complete:Event` — Se distribuye cuando los datos se han cargado correctamente.

	`httpStatus:HTTPStatusEvent` — Si se accede a través de HTTP y el entorno actual de Flash Player admite la obtención de códigos de estado, es posible recibir dichos eventos además de cualquier evento `complete` o `error`.

	`ioError:IOErrorEvent` — No se pudo completar la operación de carga.

	`progress:ProgressEvent` — Se distribuye al recibirse datos mientras progresa una operación de descarga.

	`securityError:SecurityErrorEvent` — Intento de operación de carga para recuperar datos desde un servidor fuera del entorno limitado de seguridad del elemento que realiza la llamada. Esto puede resolverse utilizando un archivo de política en el servidor.

	`securityError:SecurityErrorEvent` — Una operación de carga ha intentado cargar un archivo SWZ (un componente de plataforma de Adobe), pero el certificado no es válido o la cadena digest no coincide con el componente.

	`open:Event` — Se distribuye cuando se inicia la operación de carga.

	`httpResponseStatus:HTTPStatusEvent` — Se distribuye si una llamada al método `load()` intenta acceder a los datos mediante HTTP y Adobe AIR puede detectar y devolver el código de estado de la petición.

Emite

	`ArgumentError` — Es posible que los objetos `URLRequest.requestHeader` no contengan determinados encabezados de petición HTTP no permitidos. Para más información, consulte la descripción de la clase URLRequestHeader.

	`MemoryError` — Este error puede producirse por los motivos siguientes: 1) Flash Player o AIR no pueden convertir el parámetro `URLRequest.data` de UTF8 a MBCS. Este error es aplicable si se define el objeto URLRequest transferido a `load()` para que lleve a cabo una operación `GET` y si `System.useCodePage` está establecido como `true`. 2) Flash Player o AIR no pueden asignar memoria para los datos de `POST`. Este error se aplica si se define el objeto URLRequest transferido a `load` para que lleve a cabo una operación `POST`.

	`SecurityError` — Los archivos locales que no son de confianza no pueden comunicarse en Internet. Puede solucionar este problema reclasificando el archivo como archivo local de red o archivo de confianza.

	`SecurityError` — Si intenta conectarse a un puerto habitualmente reservado. Para obtener una lista completa de los puertos bloqueados, consulte la sección “Restricción de API de red” en el Guía del desarrollador de ActionScript 3.0.

	`TypeError` — El valor del parámetro de solicitud o de la propiedad `URLRequest.url` del objeto URLRequest transferido es `null`.

Elementos de API relacionados

URLRequestHeader
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest

Información sobre eventos

complete

Evento

Tipo de objeto de evento: flash.events.Event
propiedad Event.type = flash.events.Event.COMPLETE

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Se distribuye tras decodificar y colocar todos los datos recibidos en la propiedad data del objeto URLLoader. Es posible acceder a los datos recibidos una vez distribuido este evento.

La constante Event.COMPLETE define el valor de la propiedad type de un objeto de evento complete.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Objeto de red que ha terminado de cargarse.

Elementos de API relacionados

URLLoader.load()

httpResponseStatus

Evento

Tipo de objeto de evento: flash.events.HTTPStatusEvent
propiedad HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, AIR 1.0, Flash Lite 4

Se distribuye si una llamada al método load() intenta acceder a los datos mediante HTTP y Adobe AIR puede detectar y devolver el código de estado de la petición.

Al contrario que httpStatus, el evento httpResponseStatus se envía antes de cualquier dato de respuesta. Asimismo, el evento httpResponseStatus incluye valores para las propiedades responseHeaders y responseURL (que son undefined en un evento httpStatus). Tenga en cuenta que se enviará el evento httpResponseStatus (si existe) antes que (y además de) cualquier evento complete o error.

La constante HTTPStatusEvent.HTTP_RESPONSE_STATUS define el valor de la propiedad type de un objeto de evento httpResponseStatus.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`responseURL`	URL desde la que se devolvió la respuesta.
`responseHeaders`	Encabezados de respuesta devueltos por la respuesta como un conjunto de objeto URLRequestHeader.
`status`	El código de estado HTTP que devuelve el servidor.
`redirected`	Indica si la respuesta es el resultado de una redirección.
`target`	El objeto de red que recibe el código de estado HTTP.

Elementos de API relacionados

load()

httpStatus

Evento

Tipo de objeto de evento: flash.events.HTTPStatusEvent
propiedad HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Se distribuye si una llamada al método URLLoader.load() intenta acceder a los datos mediante HTTP. Para contenido ejecutado en Flash Player, este evento sólo se distribuye si el entorno actual de Flash Player puede detectar y devolver el código de estado de la petición. (Es posible que algunos entornos de navegador no proporcionen esta información.) Tenga en cuenta que se enviará el evento httpStatus (si existe) antes que (y además de) cualquier evento complete o error.

La constante HTTPStatusEvent.HTTP_STATUS define el valor de la propiedad type de un objeto de evento httpStatus.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`status`	El código de estado HTTP que devuelve el servidor.
`target`	El objeto de red que recibe el código de estado HTTP.

Elementos de API relacionados

URLLoader.load()

ioError

Evento

Tipo de objeto de evento: flash.events.IOErrorEvent
propiedad IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Se distribuye si el resultado de una llamada a URLLoader.load() es un error grave que hace que la descarga finalice.

Define el valor de la propiedad type de un objeto de evento ioError.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`errorID`	Un número de referencia asociado al error concreto (sólo AIR).
`target`	El objeto de red en el que se produce el error de entrada/salida.
`text`	Texto que se mostrará como mensaje de error.

Elementos de API relacionados

URLLoader.load()

open

Evento

Tipo de objeto de evento: flash.events.Event
propiedad Event.type = flash.events.Event.OPEN

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Se distribuye cuando se inicia la operación de descarga tras una llamada al método URLLoader.load().

La constante Event.OPEN define el valor de la propiedad type de un objeto de evento open.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Objeto de red que ha abierto una conexión.

Elementos de API relacionados

URLLoader.load()

progress

Evento

Tipo de objeto de evento: flash.events.ProgressEvent
propiedad ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Se distribuye al recibirse datos mientras progresa una operación de descarga.

Tenga en cuenta que con un objeto URLLoader no es posible acceder a los datos hasta que no se reciben por completo. Por tanto, el evento de progreso únicamente sirve de notificación para saber qué grado de progreso ha alcanzado la descarga. Para acceder a los datos antes de que se descarguen por completo, utilice un objeto AVURLStream.

Define el valor de la propiedad type de un objeto de evento progress.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`bytesLoaded`	Número de elementos o bytes cargados en el momento en que el detector procesa el evento.
`bytesTotal`	Número total de elementos o bytes que se cargarán en última instancia si el proceso de carga se realiza correctamente.
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	El objeto que informa sobre el progreso.

Elementos de API relacionados

URLLoader.load()

securityError

Evento

Tipo de objeto de evento: flash.events.SecurityErrorEvent
propiedad SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Se distribuye si se intenta llamar a URLLoader.load() para cargar datos de un servidor situado fuera del entorno limitado de seguridad. También se distribuye si una llamada a URLLoader.load() intenta cargar un archivo SWZ y el certificado no es válido, o si la cadena digest no coincide con el componente.

La constante SecurityErrorEvent.SECURITY_ERROR define el valor de la propiedad type de un objeto de evento securityError.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	El objeto de red que informa sobre le error de seguridad.
`text`	Texto que se mostrará como mensaje de error.

Elementos de API relacionados

URLLoader.load()

Avisos legales | Política de privacidad en línea

AVURLLoader - AS3

Paquetesx

Elementos del lenguaje

Apéndices

Paquete flash.media

cookieHeader

AVURLLoader

addEventListener

close

load

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError