URLFilePromise

Pakket	air.desktop
Klasse	public class URLFilePromise
Overerving	URLFilePromise EventDispatcher Object
Implementatie	IFilePromise

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Met de URLFilePromise-klasse kunnen bronnen die toegankelijk zijn via een URL als een bestandspromise uit een AIR-toepassing worden gesleept.

De URLFilePromise-klasse implementeert de IFilePromise-interface met URLStream- en URLRequest-objecten als gegevensbron. De implementatie biedt ondersteuning bij slepen en neerzetten voor bestanden die kunnen worden opgehaald met HTTP of de andere protocollen die door de URLStream-klasse worden ondersteund.

Een URL-bestandspromise maken:

Initialiseer een of meer URLFilePromise-objecten of stel deze samen.
Voeg de URLFilePromise-objecten aan een array toe.
Voeg de array aan een nieuw Clipboard-object toe met het ClipboardFormat FILE_PROMISE_LIST.
Roep als reactie op een gebruikersbeweging de startDrag()-methode van NativeDragManager op, in het Clipboard-object met de array van bestandspromises.

Wanneer de gebruiker de sleepbewerking voltooit, downloadt de runtime de gegevens voor elke bestandspromise. De gegevens worden geopend via de URL die is opgegeven door de eigenschap request van het URLFilePromise-object en opgeslagen in het bestand dat is opgegeven in de eigenschap relativePath; Het bestand wordt relatief ten opzichte van de neerzetlocatie opgeslagen. Dus als het relatieve pad foo/bar.txt is en de bestandspromise wordt neergezet in een map met de naam home, is de locatie van het gemaakte bestand: home/foo/bar.txt. Als er een fout optreedt, wordt het bestand niet gemaakt.

Om gegevensbronnen te ondersteunen, die niet toegankelijk zijn vanaf de URLStream-klasse, implementeert u de IFilePromise-interface.

Opmerking: de AIR-runtime roept de IFilePromise-methoden open(), close() en reportError() automatisch aan. Deze methoden mogen niet worden aangeroepen door uw toepassingslogica. De gebeurtenissen open, progress, complete en close die ook door dit URLFilePromise-object worden verstuurd, zijn vooral voorzien voor foutopsporingsdoeleinden. Uw toepassing reageert niet op deze gebeurtenissen.

Deze klasse is opgenomen in het bestand aircore.swc. Adobe^® Flash^™ Builder laadt deze klasse automatisch wanneer u een project maakt voor Adobe^® AIR^™. De Adobe^® Flex^™ SDK bevat eveneens het bestand aircore.swc, dat u mee moet insluiten wanneer u de toepassing compileert als u de Flex SDK gebruikt.

Zo gebruikt u het pakket air.desktop in Adobe^® Flash^® Professional (CS4 of hoger):

Kies de opdracht Bestand > Instellingen publiceren.
Klik in het Flash-deelvenster op de knop Instellingen voor ActionScript 3.0. Selecteer Bibliotheekpad.
Klik op de knop Bladeren naar SWC-bestand. Blader naar het bestand Adobe Flash CSn/AIKn.n/framework/libs/air/aircore.swc in de installatiemap van Adobe Flash Professional.
Klik op de knop OK.
Voeg de volgende import-instructie toe aan de ActionScript 3.0-code: import air.desktop.*;

Verwante API-elementen

IFilePromise-interface
Clipboard-klasse
ClipboardFormats-klasse
NativeDragManager-klasse
URLStream-klasse
URLRequest-klasse

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		isAsync : Boolean [alleen-lezen] Geeft aan of de brongegevens asynchroon beschikbaar zijn.	URLFilePromise
		relativePath : String Het pad en de bestandsnaam van het gemaakte bestand, afhankelijk van de neerzetbestemming.	URLFilePromise
		request : URLRequest De URLRequest die de bron identificeert, die als gevolg van de sleepbewerking wordt gekopieerd.	URLFilePromise

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		URLFilePromise() Maakt een URLFilePromise-object.	URLFilePromise
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.	EventDispatcher
		close():void Hiermee kan de AIR-runtime de gegevensbron op het juiste tijdstip tijdens de sleepbewerking sluiten.	URLFilePromise
		dispatchEvent(event:Event):Boolean Verzendt een gebeurtenis naar de gebeurtenisstroom.	EventDispatcher
		hasEventListener(type:String):Boolean Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	EventDispatcher
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		open():IDataInput Hiermee kan de AIR-runtime de gegevensbron op het juiste tijdstip tijdens de sleepbewerking openen.	URLFilePromise
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	EventDispatcher
		reportError(e:ErrorEvent):void Hiermee kan de AIR-runtime fouten melden die optreden tijdens het openen van de sleepbewerking.	URLFilePromise
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven object.	Object
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	EventDispatcher

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

Overerfde gebeurtenissen verbergen

Overerfde gebeurtenissen weergeven

	Overzicht	Gedefinieerd door
activate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.	EventDispatcher
complete	Wordt verzonden wanneer de gegevens voor het bestand volledig zijn gedownload.	URLFilePromise
deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	EventDispatcher
httpResponseStatus	Wordt verzonden voor HTTP-aanvragen om de reactiekopteksten te melden.	URLFilePromise
httpStatus	Wordt verzonden voor HTTP-aanvragen om de aanvraagstatuscode te melden.	URLFilePromise
ioError	Wordt verzonden wanneer een IOError het downloaden van het bestand voorkomt.	URLFilePromise
open	Wordt verzonden wanneer de onderliggende URLStream-verbinding geopend is.	URLFilePromise
progress	Wordt verzonden wanneer een gegevensblok beschikbaar is voor lezen vanaf de onderliggende URLStream.	URLFilePromise
securityError	Wordt verzonden wanneer een beveiligingsfout het downloaden van het bestand voorkomt.	URLFilePromise

Eigenschapdetails

isAsync

eigenschap

isAsync:Boolean [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Geeft aan of de brongegevens asynchroon beschikbaar zijn.

De isAsync-eigenschap van een URLFilePromise-object is altijd true, omdat URL-streams inherent synchroon zijn.

Implementatie
public function get isAsync():Boolean

relativePath

eigenschap

relativePath:String

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Het pad en de bestandsnaam van het gemaakte bestand, afhankelijk van de neerzetbestemming.

Het pad kan submappen bevatten, die worden opgelost op basis van de neerzetlocatie. Indien nodig, worden de submappen gemaakt. Gebruik de File.separator-constante wanneer u submappen toevoegt, om het juiste padscheidingsteken voor het huidige besturingssysteem in te voegen. Bij het gebruik van de header .. een sneltoets naar een bovenliggende map is niet toegestaan.

De bestandsnaam hoeft niet gelijk te zijn aan de bestandsnaam van de bron op afstand.

Implementatie
public function get relativePath():String
public function set relativePath(value:String):void

request

eigenschap

request:URLRequest

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

De URLRequest die de bron identificeert, die als gevolg van de sleepbewerking wordt gekopieerd.

Implementatie
public function get request():URLRequest
public function set request(value:URLRequest):void

Constructordetails

()

Constructor

public function URLFilePromise()

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Maakt een URLFilePromise-object.

U moet de eigenschappen request en relativePath instellen voordat u dit URLFilePromise-object gebruikt.

Methodedetails

close

()

methode

public function close():void

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Hiermee kan de AIR-runtime de gegevensbron op het juiste tijdstip tijdens de sleepbewerking sluiten.

Roep deze functie niet op in uw toepassingslogica.

open

()

methode

public function open():IDataInput

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Hiermee kan de AIR-runtime de gegevensbron op het juiste tijdstip tijdens de sleepbewerking openen.

Roep deze functie niet op in uw toepassingslogica.

Geretourneerde waarde

IDataInput

reportError

()

methode

public function reportError(e:ErrorEvent):void

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Hiermee kan de AIR-runtime fouten melden die optreden tijdens het openen van de sleepbewerking.

Het URLFilePromise-object verstuurt gerapporteerde foutgebeurtenissen opnieuw. Roep deze functie niet op in uw toepassingslogica.

Parameters

e:ErrorEvent

Gebeurtenisdetails

complete

Gebeurtenis

Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.COMPLETE

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Wordt verzonden wanneer de gegevens voor het bestand volledig zijn gedownload.

Opmerking: de AIR-runtime gebruikt deze gebeurtenis voor het beheren van het ophaalproces voor asynchrone gegevens. Het is normaal gezien niet nodig, dat uw toepassing als gevolg van deze gebeurtenis een actie onderneemt.

De constante Event.COMPLETE definieert de waarde van de eigenschap type van een complete-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`target`	Het netwerkobject dat klaar is met laden.

httpResponseStatus

Gebeurtenis

Type gebeurtenisobject: flash.events.HTTPStatusEvent
eigenschap HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Wordt verzonden voor HTTP-aanvragen om de reactiekopteksten te melden.

In tegenstelling tot de gebeurtenis httpStatus, wordt de gebeurtenis httpResponseStatusvóór eventuele responsgegevens bezorgd. Bovendien bevat de gebeurtenis httpResponseStatus waarden voor de eigenschappen responseHeaders en responseURL (die ongedefinieerd zijn voor een httpStatus-gebeurtenis). De gebeurtenis httpResponseStatus (indien aanwezig) wordt verzonden vóór (en als aanvulling op) een gebeurtenis complete of error.

De constante HTTPStatusEvent.HTTP_RESPONSE_STATUS definieert de waarde van de eigenschap type van een httpResponseStatus-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`responseURL`	De URL waar het antwoord vandaan komt.
`responseHeaders`	De antwoordheaders die door het antwoord zijn geretourneerd, als een array van URLRequestHeader-objecten.
`status`	De HTTP-statuscode die door de server wordt geretourneerd.
`redirected`	Of de reactie het resultaat is van een omleiding.
`target`	Het netwerkobject dat de HTTP-statuscode ontvangt.

httpStatus

Gebeurtenis

Type gebeurtenisobject: flash.events.HTTPStatusEvent
eigenschap HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Wordt verzonden voor HTTP-aanvragen om de aanvraagstatuscode te melden.

De constante HTTPStatusEvent.HTTP_STATUS definieert de waarde van de eigenschap type van een httpStatus-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`status`	De HTTP-statuscode die door de server wordt geretourneerd.
`target`	Het netwerkobject dat de HTTP-statuscode ontvangt.

ioError

Gebeurtenis

Type gebeurtenisobject: flash.events.IOErrorEvent
eigenschap IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Wordt verzonden wanneer een IOError het downloaden van het bestand voorkomt.

Definieert de waarde van de eigenschap type van een gebeurtenisobject ioError.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`errorID`	Een referentienummer dat aan de specifieke fout is gekoppeld (alleen AIR).
`target`	Het netwerkobject dat de invoer-/uitvoerfout ondervindt.
`text`	Tekst die moet worden weergegeven als foutbericht.

open

Gebeurtenis

Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.OPEN

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Wordt verzonden wanneer de onderliggende URLStream-verbinding geopend is.

De constante Event.OPEN definieert de waarde van de eigenschap type van een open-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`target`	Het netwerkobject dat de verbinding heeft geopend.

progress

Gebeurtenis

Type gebeurtenisobject: flash.events.ProgressEvent
eigenschap ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Wordt verzonden wanneer een gegevensblok beschikbaar is voor lezen vanaf de onderliggende URLStream.

Definieert de waarde van de eigenschap type van een gebeurtenisobject progress.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`bytesLoaded`	Het aantal items of bytes dat wordt geladen wanneer de listener de gebeurtenis verwerkt.
`bytesTotal`	Het totale aantal items of bytes dat uiteindelijk wordt geladen wanneer het laadproces is voltooid.
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`target`	Het object dat de voortgang rapporteert.

securityError

Gebeurtenis

Type gebeurtenisobject: flash.events.SecurityErrorEvent
eigenschap SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.0

Wordt verzonden wanneer een beveiligingsfout het downloaden van het bestand voorkomt.

De constante SecurityErrorEvent.SECURITY_ERROR definieert de waarde van de eigenschap type van een gebeurtenisobject securityError.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`target`	Het netwerkobject dat de beveiligingsfout rapporteert.
`text`	Tekst die moet worden weergegeven als foutbericht.

Juridische kennisgeving | Online privacybeleid

URLFilePromise - AS3

Pakkettenx

Taalelementen

Bijlagen

Pakket air.desktop

isAsync

relativePath

request

URLFilePromise

close

open

reportError

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError