URLFilePromise

Paket	air.desktop
Klass	public class URLFilePromise
Arv	URLFilePromise EventDispatcher Object
Implementerar	IFilePromise

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Klassen URLFilePromise tillåter att de resurser som är tillgängliga för en webbadress dras ut ur ett AIR-program som ett fillöfte.

Klassen URLFilePromise implementerar IFilePromise-gränssnittet med URLStream- och URLRequest-objekten som datakälla. Implementeringen aktiverar dra- och-släpp-funktioner för filer som kan hämtas med HTTP eller andra protokoll som stöds av klassen URLStream.

Så här skapar du ett URL-fillöfte:

Skapa och initiera ett eller flera URLFilePromise-objekt.
Lägg till URLFilePromise-objekten i en array.
Lägg till arrayen till ett nytt Clipboard-objekt med ClipboardFormat FILE_PROMISE_LIST.
Anropa NativeDragManager startDrag()-metoden som svar på en användarrörelse och skicka Clipboard-objektet som innehåller arrayen med fillöften.

Miljön hämtar data för varje fillöfte när användaren avslutar dra och släpp-åtgärden. Data hämtas på den URL som anges av egenskapen request i URLFilePromise-objektet och de sparas i filen som anges i egenskapen relativePath. Filen sparas relativt till var den släpptes. Om således den relativa sökvägen är foo/bar.txt och om fillöftet släpps i en katalog med namnet home, kommer platsen för den skapade filen att vara: home/foo/bar.txt. Filen skapas inte om ett fel inträffar.

Implementera IFilePromise-gränssnittet för stöd för datakällor som inte kan nås via URLStream-klassen.

Obs! AIR-miljön anropar IFilePromise-metoderna open(), close() och reportError() automatiskt. Dessa metoder ska aldrig anropas av programlogiken. På liknande sätt är händelserna open, progress, complete och close som skickas av URLFilePromise-objektet främst avsedda för felsökningsändamål. Ditt program behöver inte svara på händelserna.

Den här klassen ingår i aircore.swc-filen. Adobe^® Flash^™ Builder läser automatiskt in den här klassen när du skapar ett projekt för Adobe^® AIR^™. I Adobe^® Flex^™ SDK ingår även den här aircore.swc-filen, som du ska ta med när du kompilerar programmet om du använder Flex SDK.

Så här använder du paketet air.desktop i Adobe^® Flash^® Professional (CS4 eller senare):

Välj kommandot Arkiv > Publiceringsinställningar.
Klicka på knappen Inställningar för ActionScript 3.0 på Flash-panelen. Välj Bibliotekssökväg.
Klicka på Bläddra efter SWC-fil. Bläddra till Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc i installationsmappen för Adobe Flash Professional.
Klicka på OK.
Lägg till följande import-sats i ActionScript 3.0-koden: import air.desktop.*;

Relaterade API-element

IFilePromise-gränssnitt
Klassen Clipboard
Klassen ClipboardFormats
Klassen NativeDragManager
Klassen URLStream
Klassen URLRequest

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		isAsync : Boolean [skrivskyddad] Anger om resursdata är tillgängliga asynkront.	URLFilePromise
		relativePath : String Sökvägen till och filnamnet på den fil som skapas, i förhållande till släppningsmålet.	URLFilePromise
		request : URLRequest Den URLRequest som identifierar den resurs som ska kopieras i dra och släpp-åtgärden.	URLFilePromise

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		URLFilePromise() Skapar ett URLFilePromise-objekt.	URLFilePromise
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser.	EventDispatcher
		close():void Tillåter att AIR-miljön stänger datakällan vid lämplig tidpunkt under dra och släpp-åtgärden.	URLFilePromise
		dispatchEvent(event:Event):Boolean Skickar en händelse till händelseflödet.	EventDispatcher
		hasEventListener(type:String):Boolean Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.	EventDispatcher
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		open():IDataInput Tillåter att AIR-miljön öppnar datakällan vid lämplig tidpunkt under dra och släpp-åtgärden.	URLFilePromise
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Tar bort en avlyssnare från EventDispatcher-objektet.	EventDispatcher
		reportError(e:ErrorEvent):void Tillåter att AIR-miljön rapporterar fel som inträffar under dra och släpp-åtgärden.	URLFilePromise
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar det angivna objektets strängbeteckning.	Object
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object
		willTrigger(type:String):Boolean Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen.	EventDispatcher

Händelser

Klicka för mer information om händelser

Dölj ärvda händelser

Visa ärvda händelser

	Sammanfattning	Definieras med
activate	[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.	EventDispatcher
complete	Skickas när data för filen har hämtats helt.	URLFilePromise
deactivate	[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.	EventDispatcher
httpResponseStatus	Skickas för HTTP-begäranden för att rapportera om svarshuvud.	URLFilePromise
httpStatus	Skickas för HTTP-begäranden för att rapportera om statuskoden för begäran.	URLFilePromise
ioError	Skickas när ett IOError-fel hindrar filen från att hämtas.	URLFilePromise
open	Skickas när den underliggande URLStream-anslutningen öppnas.	URLFilePromise
progress	Skickas när ett datablock är tillgängligt för läsning från underliggande URLStream.	URLFilePromise
securityError	Skickas när ett säkerhetsfel hindrar filen från att hämtas.	URLFilePromise

Egenskapsdetaljer

isAsync

egenskap

isAsync:Boolean [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Anger om resursdata är tillgängliga asynkront.

Egenskapen isAsync för ett URLFilePrmise-objekt är alltid true eftersom URL-strömmar i sig är asynkrona.

Implementering
public function get isAsync():Boolean

relativePath

egenskap

relativePath:String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Sökvägen till och filnamnet på den fil som skapas, i förhållande till släppningsmålet.

Sökvägen kan innehålla underkataloger, som tolkas beroende på släppmålet. Underkatalogerna skapas vid behov. Om du inkluderar underkataloger använder du konstanten File.separator för att infoga korrekt sökvägsavgränsare för det aktuella operativsystemet. Du kan inte använda .. för att navigera till en överordnad katalog.

Filnamnet behöver inte vara samma som filnamnet i fjärresursen.

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

request

egenskap

request:URLRequest

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Den URLRequest som identifierar den resurs som ska kopieras i dra och släpp-åtgärden.

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

Konstruktordetaljer

()

Konstruktor

public function URLFilePromise()

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Skapar ett URLFilePromise-objekt.

Du måste ställa in egenskaperna request och relativePath innan du använder det här URLFilePromise-objektet.

Metoddetaljer

close

()

metod

public function close():void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Tillåter att AIR-miljön stänger datakällan vid lämplig tidpunkt under dra och släpp-åtgärden.

Anropa inte den här funktionen i din programlogik.

open

()

metod

public function open():IDataInput

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Tillåter att AIR-miljön öppnar datakällan vid lämplig tidpunkt under dra och släpp-åtgärden.

Anropa inte den här funktionen i din programlogik.

Returnerar

IDataInput

reportError

()

metod

public function reportError(e:ErrorEvent):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Tillåter att AIR-miljön rapporterar fel som inträffar under dra och släpp-åtgärden.

URLFilePromise-objektet skickar eventuella felhändelser som rapporterats igen. Anropa inte den här funktionen i din programlogik.

Parametrar

e:ErrorEvent

Händelsedetaljer

complete

Händelse

Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.COMPLETE

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Skickas när data för filen har hämtats helt.

Obs! I AIR-miljön används den här händelsen för att hantera asynkron datahämtning. Ditt program behöver för det mesta inte utföra något som svar på den här händelsen.

Event.COMPLETE-konstanten definierar värdet på type-egenskapen i ett complete-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`target`	Det nätverksobjekt som har lästs in.

httpResponseStatus

Händelse

Typ av händelseobjekt: flash.events.HTTPStatusEvent
egenskap HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Skickas för HTTP-begäranden för att rapportera om svarshuvud.

Till skillnad från httpStatus-händelsen levereras httpResponseStatus-händelsen innan eventuella svarsdata. Dessutom inkluderar httpResponseStatus-händelsen värdena för responseHeaders och responseURL-egenskaperna (som är odefinierade i en httpStatus-händelse). Observera att httpResponseStatus-händelsen (om sådan finns) skickas före (och utöver) händelserna complete eller error.

HTTPStatusEvent.HTTP_RESPONSE_STATUS-konstanten definierar värdet på type-egenskapen i ett httpResponseStatus-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`responseURL`	URL:en som svaret returnerades från.
`responseHeaders`	Svarsrubriken som svaret returnerade har en array med URLRequestHeader-objekt.
`status`	Den HTTP-statuskod som returneras av servern.
`redirected`	Om svaret är resultatet av en omdirigering.
`target`	Nätverksobjektet tar emot en HTTP-statuskod.

httpStatus

Händelse

Typ av händelseobjekt: flash.events.HTTPStatusEvent
egenskap HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Skickas för HTTP-begäranden för att rapportera om statuskoden för begäran.

Konstanten HTTPStatusEvent.HTTP_STATUS definierar värdet på type-egenskapen i ett httpStatus-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`status`	Den HTTP-statuskod som returneras av servern.
`target`	Nätverksobjektet tar emot en HTTP-statuskod.

ioError

Händelse

Typ av händelseobjekt: flash.events.IOErrorEvent
egenskap IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Skickas när ett IOError-fel hindrar filen från att hämtas.

Definierar värdet för ett ioError-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`errorID`	Ett referensnummer som associeras med det specifika felet (enbart AIR).
`target`	Objektet är med om ett in-/utdatafel.
`text`	Text som visas som felmeddelande.

open

Händelse

Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.OPEN

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Skickas när den underliggande URLStream-anslutningen öppnas.

Obs! I AIR-miljön används den här händelsen för att hantera asynkron datahämtning. Ditt program behöver för det mesta inte utföra något som svar på den här händelsen.

Event.OPEN-konstanten definierar värdet på type-egenskapen i ett open-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`target`	Det nätverksobjekt som har öppnat en anslutning.

progress

Händelse

Typ av händelseobjekt: flash.events.ProgressEvent
egenskap ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Skickas när ett datablock är tillgängligt för läsning från underliggande URLStream.

Obs! I AIR-miljön används den här händelsen för att hantera asynkron datahämtning. Ditt program behöver för det mesta inte utföra något som svar på den här händelsen.

Definierar värdet för ett progress-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`bytesLoaded`	Antalet objekt eller byte som har lästs in när avlyssnaren bearbetar händelsen.
`bytesTotal`	Det totala antalet objekt eller byte som kommer att ha lästs in om inläsningen lyckas.
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`target`	Objektet rapporterar förlopp.

securityError

Händelse

Typ av händelseobjekt: flash.events.SecurityErrorEvent
egenskap SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.0

Skickas när ett säkerhetsfel hindrar filen från att hämtas.

Konstanten SecurityErrorEvent.SECURITY_ERROR definierar värdet för ett securityError-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`target`	Nätverksobjektet rapporterar säkerhetsfelet.
`text`	Text som visas som felmeddelande.

Juridiska meddelanden | Onlinesekretesspolicy

URLFilePromise - AS3

Klasser x

isAsync

relativePath

request

URLFilePromise

close

open

reportError

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError