| Pakket | air.desktop |
| Klasse | public class URLFilePromise |
| Overerving | URLFilePromise  EventDispatcher Object |
| Implementatie | IFilePromise |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.0 |
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
Clipboard-klasse
ClipboardFormats-klasse
NativeDragManager-klasse
URLStream-klasse
URLRequest-klasse
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 | ||
| Methode | Gedefinieerd door | ||
|---|---|---|---|
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 | |
Hiermee kan de AIR-runtime de gegevensbron op het juiste tijdstip tijdens de sleepbewerking sluiten. | URLFilePromise | ||
|
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | |
|
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | |
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
Hiermee kan de AIR-runtime de gegevensbron op het juiste tijdstip tijdens de sleepbewerking openen. | URLFilePromise | ||
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | |
Hiermee kan de AIR-runtime fouten melden die optreden tijdens het openen van de sleepbewerking. | URLFilePromise | ||
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
|
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | |
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
|
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher | |
| Gebeurtenis | Overzicht | Gedefinieerd door | ||
|---|---|---|---|---|
| [uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | ||
| Wordt verzonden wanneer de gegevens voor het bestand volledig zijn gedownload. | URLFilePromise | |||
| [uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | ||
| Wordt verzonden voor HTTP-aanvragen om de reactiekopteksten te melden. | URLFilePromise | |||
| Wordt verzonden voor HTTP-aanvragen om de aanvraagstatuscode te melden. | URLFilePromise | |||
| Wordt verzonden wanneer een IOError het downloaden van het bestand voorkomt. | URLFilePromise | |||
| Wordt verzonden wanneer de onderliggende URLStream-verbinding geopend is. | URLFilePromise | |||
| Wordt verzonden wanneer een gegevensblok beschikbaar is voor lezen vanaf de onderliggende URLStream. | URLFilePromise | |||
| Wordt verzonden wanneer een beveiligingsfout het downloaden van het bestand voorkomt. | URLFilePromise | |||
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 URLFilePromise | () | 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.
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 waardeIDataInput |
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 |
complete | Gebeurtenis |
flash.events.Eventeigenschap 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 constanteEvent.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 |
flash.events.HTTPStatusEventeigenschap 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 gebeurtenishttpStatus, 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 |
flash.events.HTTPStatusEventeigenschap 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 constanteHTTPStatusEvent.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 |
flash.events.IOErrorEventeigenschap 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 eigenschaptype 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 |
flash.events.Eventeigenschap Event.type =
flash.events.Event.OPEN| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.0 |
Wordt verzonden wanneer de onderliggende URLStream-verbinding geopend is.
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 constanteEvent.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 |
flash.events.ProgressEventeigenschap 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.
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.
Definieert de waarde van de eigenschaptype 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 |
flash.events.SecurityErrorEventeigenschap 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 constanteSecurityErrorEvent.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. |
Wed Jun 13 2018, 11:42 AM Z