URLFilePromise

Paquete	air.desktop
Clase	public class URLFilePromise
Herencia	URLFilePromise EventDispatcher Object
Implementa	IFilePromise

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 2.0

La clase URLFilePromise permite que los recursos accesibles en una dirección URL se puedan arrastrar fuera de una aplicación de AIR como una promesa de archivo.

La clase URLFilePromise implementa la interfaz IFilePromise usando objetos URLStream y URLRequest como origen de datos. La aplicación proporciona compatibilidad de arrastrar y colocar para los archivos que se pueden recuperar mediante HTTP o los otros protocolos admitidos por la clase URLStream.

Para crear una promesa de archivo URL:

Construya e inicialice uno o más objetos URLFilePromise.
Añada objetos URLFilePromise a un conjunto.
Añada el conjunto a un nuevo objeto Clipboard utilizando el formato ClipboardFormat FILE_PROMISE_LIST.
Como respuesta a un gesto del usuario, llame al método startDrag() de NativeDragManager y transfiera el objeto Clipboard que contiene el conjunto de promesas de archivo.

Cuando el usuario finalice la operación de arrastre, el motor de ejecución descargará los datos de cada promesa de archivo. Se accede a los datos en la URL especificada por la propiedad request del objeto URLFilePromise y se guardan en el archivo especificado en la propiedad relativePath. El archivo se guarda con respecto a la ubicación de destino. Por consiguiente, si la ruta relativa es foo/bar.txt, y el archivo promesa se coloca en un directorio llamado home, la ubicación del archivo creado es: home/foo/bar.txt. Si se produce un error, el archivo no se crea.

Para poder admitir orígenes de datos que no están accesibles a través de la clase URLStream, implemente la interfaz IFilePromise.

Nota: el motor de ejecución de AIR llama a los métodos open(), close() y reportError() de IFilePromise automáticamente. Nunca se debe llamar a estos métodos desde la lógica de la aplicación. De forma similar, los eventos open, progress, complete y close distribuidos mediante este objeto URLFilePromise se suministran principalmente por motivos de depuración. No es necesario que su aplicación responda a estos eventos.

Esta clase está incluida en el archivo aircore.swc. Adobe^® Flash^™ Builder carga esta clase automáticamente al crear un proyecto para Adobe^® AIR^™. El SDK de Adobe^® Flex^™ también contiene este archivo aircore.swc, que se debe incluir al compilar la aplicación si se utiliza el SDK de Flex.

Para utilizar el paquete air.desktop en Adobe^® Flash^® Professional (CS4 o posterior):

Seleccione el comando Archivo > Configuración de publicación.
En el panel Flash, haga clic en el botón Configuración de Seleccionar ruta de biblioteca de ActionScript 3.0.
Haga clic en el botón Navegar hasta el archivo SWC. En la carpeta de instalación de Adobe Flash Professional, navegue hasta Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc.
Haga clic en el botón Aceptar.
Añada la siguiente sentencia import al código ActionScript 3.0: import air.desktop.*;

Elementos de API relacionados

Interfaz IFilePromise
Clase Clipboard
Clase ClipboardFormats
Clase NativeDragManager
Clase URLStream
Clase URLRequest

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		isAsync : Boolean [solo lectura] Indica si los datos del recurso están disponibles asíncronamente.	URLFilePromise
		relativePath : String La ruta y el nombre de archivo del archivo creado, relativos al destino en que se va a colocar.	URLFilePromise
		request : URLRequest El objeto URLRequest que identifica el recurso que se va a copiar como resultado de la operación de arrastrar y colocar.	URLFilePromise

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		URLFilePromise() Crea un objeto URLFilePromise.	URLFilePromise
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.	EventDispatcher
		close():void Permite que el motor de ejecución de AIR cierre el origen de datos en el momento adecuado durante la operación de arrastrar y colocar.	URLFilePromise
		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
		open():IDataInput Permite que el motor de ejecución de AIR abra el origen de datos en el momento adecuado durante la operación de arrastrar y colocar.	URLFilePromise
		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
		reportError(e:ErrorEvent):void Permite que el motor de ejecución de AIR informe sobre los errores que se producen durante la operación de arrastrar y colocar.	URLFilePromise
		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 cuando se han descargado completamente los datos del el archivo.	URLFilePromise
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher
httpResponseStatus	Se distribuye para que las peticiones HTTP puedan informar sobre los encabezados de respuesta.	URLFilePromise
httpStatus	Se distribuye para que las peticiones HTTP informen sobre el código de estado de la petición.	URLFilePromise
ioError	Se distribuye cuando un error IOError impide la descarga del archivo.	URLFilePromise
open	Se distribuye cuando se abre la conexión URLStream subyacente.	URLFilePromise
progress	Se distribuye cuando un bloque de datos está disponibles para su lectura en el flujo URLStream subyacente.	URLFilePromise
securityError	Se distribuye cuando un error de seguridad impide la descarga del archivo.	URLFilePromise

Información sobre propiedades

isAsync

propiedad

isAsync:Boolean [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 2.0

Indica si los datos del recurso están disponibles asíncronamente.

La propiedad isAsync de un objeto URLFilePrmise siempre es true ya que los flujos URL son esencialmente asíncronos.

Implementación
public function get isAsync():Boolean

relativePath

propiedad

relativePath:String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 2.0

La ruta y el nombre de archivo del archivo creado, relativos al destino en que se va a colocar.

La ruta puede incluir subdirectorios que se resuelven en función de la ubicación en que se va a colocar. Se crean subdirectorios, si es necesario. Si se incluyen subdirectorios, utilice la constante File.separator para insertar el carácter separador de ruta correcto para el sistema operativo actual. Utilizar el acceso directo .. para navegar a un directorio principal no está permitido.

El nombre de archivo no tiene que coincidir necesariamente con el nombre de archivo del recurso remoto.

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

request

propiedad

request:URLRequest

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 2.0

El objeto URLRequest que identifica el recurso que se va a copiar como resultado de la operación de arrastrar y colocar.

Implementación
public function get request():URLRequest
public function set request(value:URLRequest):void

Información sobre constructores

()

Información sobre

public function URLFilePromise()

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 2.0

Crea un objeto URLFilePromise.

Debe definir las propiedades request y relativePath antes de utilizar este objeto URLFilePromise.

Información sobre métodos

close

()

método

public function close():void

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 2.0

Permite que el motor de ejecución de AIR cierre el origen de datos en el momento adecuado durante la operación de arrastrar y colocar.

No llame a esta función en la lógica de la aplicación.

open

()

método

public function open():IDataInput

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 2.0

Permite que el motor de ejecución de AIR abra el origen de datos en el momento adecuado durante la operación de arrastrar y colocar.

No llame a esta función en la lógica de la aplicación.

Valor devuelto

IDataInput

reportError

()

método

public function reportError(e:ErrorEvent):void

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 2.0

Permite que el motor de ejecución de AIR informe sobre los errores que se producen durante la operación de arrastrar y colocar.

El objeto URLFilePromise redistribuye cualquier evento de error notificado. No llame a esta función en la lógica de la aplicación.

Parámetros

e:ErrorEvent

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 2.0

Se distribuye cuando se han descargado completamente los datos del el archivo.

Nota: el motor de ejecución de AIR utiliza este evento para gestionar el proceso de recuperación asíncrona de datos. Normalmente, no es necesario que la aplicación realice ninguna acción como respuesta a 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.

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 2.0

Se distribuye para que las peticiones HTTP puedan informar sobre los encabezados de respuesta.

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.

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 2.0

Se distribuye para que las peticiones HTTP informen sobre el código de estado de la petición.

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.

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 2.0

Se distribuye cuando un error IOError impide la descarga del archivo.

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.

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 2.0

Se distribuye cuando se abre la conexión URLStream subyacente.

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.

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 2.0

Se distribuye cuando un bloque de datos está disponibles para su lectura en el flujo URLStream subyacente.

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.

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 2.0

Se distribuye cuando un error de seguridad impide la descarga del archivo.

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.

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

URLFilePromise - AS3

Paquetesx

Elementos del lenguaje

Apéndices

Paquete air.desktop

isAsync

relativePath

request

URLFilePromise

close

open

reportError

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError