AVURLLoader

Paket	flash.media
Klass	public class AVURLLoader
Arv	AVURLLoader URLLoader EventDispatcher Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Klassen URLLoader laddar ned data från en URL som text, binära data eller URL-kodade variabler. Det är praktiskt vid nedladdning av textfiler, XML eller annan information som ska användas i dynamiska, datastyrda program.

Ett URLLoader-objekt laddar ned alla data från en URL innan den görs tillgänglig för kod i programmen. Aviseringar om förloppet av nedladdningen skickas ut. Du kan bevaka dem via egenskaperna bytesLoaded och bytesTotal samt även via skickade händelser.

När en mycket stor videofil (som FVL) läses in kan minnesproblem uppstå.

När du använder den här klassen i Flash Player och i AIR-programinnehåll i andra säkerhetssandlådor än programsäkerhetssandlådan, bör du överväga att använda följande säkerhetsmodell:

En SWF-fil i sandlådan lokal-med-filsystem kan inte hämta data från, eller leverera data till, en resurs som finns i nätverkssandlådan.
Den anropade SWF-filen och URL:en som du läser in, måste som standard finnas i exakt samma domän. En SWF-fil på www.adobe.com kan till exempel bara läsa in data från källor som också finns på www.adobe.com. Om du vill läsa in data från en annan domän sparar du en URL-principfil på servern där data finns.

Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.

Relaterade API-element

URLRequest
URLVariables
AVURLStream

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		bytesLoaded : uint = 0 Anger antalet byte som har hämtats hittills under inläsningen.	URLLoader
		bytesTotal : uint = 0 Anger det totala antalet databyte som laddas ned.	URLLoader
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		cookieHeader : String [lässkyddad]	AVURLLoader
		data : * De data som tas emot från inläsningen.	URLLoader
		dataFormat : String = "text" Styr om laddade ned data tas emot som text (URLLoaderDataFormat.TEXT), binära rådata (URLLoaderDataFormat.BINARY) eller URL-kodade variabler (URLLoaderDataFormat.VARIABLES).	URLLoader

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		AVURLLoader(request:URLRequest = null) Skapar ett URLLoader-objekt.	AVURLLoader
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [åsidosätt]	AVURLLoader
		close():void [åsidosätt] Stänger den pågående inläsningen.	AVURLLoader
		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
		load(request:URLRequest):void [åsidosätt] Skickar och läser in data från den angivna URL:en.	AVURLLoader
		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
		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 alla mottagna data har avkodats och placerats i egenskapen data i URLLoader-objektet.	AVURLLoader
deactivate	[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.	EventDispatcher
httpResponseStatus	Skickas om ett anrop till metoden load() försöker få tillgång till data via HTTP och Adobe AIR kan identifiera och returnera statuskoden för begäran.	AVURLLoader
httpStatus	Skickas när ett anrop till URLLoader.load() försöker komma åt data via HTTP.	AVURLLoader
ioError	Skickas om ett anrop till URLLoader.load() resulterar i ett allvarligt fel som gör att nedladdningen avbryts.	AVURLLoader
open	Skickas när nedladdningen påbörjas efter anropet till metoden URLLoader.load().	AVURLLoader
progress	Skickas när data tas emot under nedladdningsförloppet.	AVURLLoader
securityError	Skickas när ett anrop till URLLoader.load() försöker läsa in data från en server utanför säkerhetssandlådan.	AVURLLoader

Egenskapsdetaljer

cookieHeader

egenskap

cookieHeader:String [lässkyddad]

Implementering
public function set cookieHeader(value:String):void

Konstruktordetaljer

()

Konstruktor

public function AVURLLoader(request:URLRequest = null)

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skapar ett URLLoader-objekt.

Parametrar

request:URLRequest (default = null) — Ett URLRequest-objekt som anger vilket URL som ska laddas ned. Om du inte inkluderar denna parameter initieras ingen hämtning. Hämtningen startar omedelbart om den har angetts (se posten load för mer information).

Relaterade API-element

URLLoader.load()

Metoddetaljer

addEventListener

()

metod

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

Parametrar

	`type:String`

	`listener:Function`

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

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

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

close

()

metod

override public function close():void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Stänger den pågående inläsningen. Eventuell pågående inläsning avslutas omedelbart. Om det inte finns någon URL för direktuppspelning utlöser ett fel för ogiltig dataström.

load

()

metod

override public function load(request:URLRequest):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skickar och läser in data från den angivna URL:en. Alla data kan tas emot som text, binära rådata eller URL-kodade variabler beroende på värdet du anger för egenskapen dataFormat. Observera att standardvärdet för egenskapen dataFormat är text. Om du vill skicka data till angiven URL kan du använda egenskapen data i objektet URLRequest.

Obs!Om en fil som läses in innehåller andra tecken än ASCII-tecken (finns i många icke-engelska språk) rekommenderas att du sparar filen med UTF-8 eller UTF-16-kodning i stället för ett icke-Unicode-format som ASCII.

En SWF-fil i sandlådan lokal-med-filsystem kan inte hämta data från, eller leverera data till, en resurs som finns i nätverkssandlådan.

Den anropade SWF-filen och URL:en som du läser in, måste som standard finnas i exakt samma domän. En SWF-fil på www.adobe.com kan till exempel bara läsa in data från källor som också finns på www.adobe.com. Om du vill läsa in data från en annan domän sparar du en URL-principfil på servern där data finns.

Du kan inte ansluta till vanligtvis reserverade portar. Du hittar en fullständig lista över spärrade portar i avsnittet ”Begränsa nätverks-API:er” i Utvecklarhandbok för Adobe ActionScript 3.0.

Om du i Flash Player 10 eller senare använder en multipart-innehållstyp (till exempel ”multipart/form-data”) som innehåller en överföring (vilket indikeras av en ”filename”-parameter i ett ”content-disposition”-huvud inuti POST), gäller de säkerhetsregler som används för överföringar också för POST-åtgärden.

POST-åtgärden måste utföras som ett svar på en användarinitierad åtgärd som exempelvis en musklickning eller en tangenttryckning.
Om POST-åtgärden är för korsdomän (POST-målet ligger inte på samma server som SWF-filen som skickar POST-begäran), måste målservern ha en URL-policyfil som tillåter korsdomänåtkomst.

För en multipart-innehållstyp måste också syntaxen vara giltig (enligt RFC2046-standarderna). Om syntaxen verkar vara ogiltig, gäller samma regler för POST-åtgärden som för överföringar.

Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.

Parametrar

request:URLRequest — Ett URLRequest-objekt som anger vilket URL som ska laddas ned.

Händelser

	`complete:Event` — Skickas när alla data är inlästa.

	`httpStatus:HTTPStatusEvent` — Om åtkomsten sker via HTTP, och den aktuella Flash Player-miljön stöder hämtning av statuskoder, kan dessa händelser skickas utöver eventuella `complete`- eller `error`-händelser.

	`ioError:IOErrorEvent` — Det gick inte att slutföra inläsningen.

	`progress:ProgressEvent` — Skickas när data tas emot under nedladdningsförloppet.

	`securityError:SecurityErrorEvent` — En inläsningsåtgärd försökte hämta data från en server utanför anroparens säkerhetssandlåda. Detta kan åtgärdas genom att använda en policyfil på servern.

	`securityError:SecurityErrorEvent` — En inläsningsåtgärd försökte läsa in en SWZ-fil (en Adobe-plattformskomponent), men certifikatet är ogiltigt eller så matchar sammanfattningen inte komponenten.

	`open:Event` — Skickas när en inläsning initieras.

	`httpResponseStatus:HTTPStatusEvent` — Skickas om ett anrop till metoden `load()` försöker komma åt data via HTTP och Adobe AIR kan identifiera och returnera statuskoden för begäran.

Utlöser

	`ArgumentError` — Objekten `URLRequest.requestHeader` får inte innehålla vissa förbjudna rubriker för HTTP-begäran. Mer information finns i beskrivningen av klassen URLRequestHeader.

	`MemoryError` — Detta fel kan bero på följande: 1) Flash Player eller AIR kan inte konvertera parametern `URLRequest.data` från UTF8 till MBCS. Detta fel uppstår om objektet URLRequest som skickas till `load()` är inställt för en `GET`-åtgärd och om `System.useCodePage` är angivet med `true`. 2) Flash Player eller AIR kan inte tilldela minne för `POST`-data. Detta fel uppstår om objektet URLRequest som skickas till `load` är inställt för en `POST`-åtgärd.

	`SecurityError` — Lokala otillförlitliga filer kanske inte kan kommunicera med Internet. Du kan lösa problemet genom att klassificera om filen som lokal med nätverkstjänst eller tillförlitlig.

	`SecurityError` — Du försöker ansluta till en vanligtvis reserverad port. Du hittar en fullständig lista över spärrade portar i avsnittet ”Begränsa nätverks-API:er” i Utvecklarhandbok för Adobe ActionScript 3.0.

	`TypeError` — Värdet för begäranparametern eller egenskapen `URLRequest.url` för objektet URLRequest som skickas är `null`.

Relaterade API-element

URLRequestHeader
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest

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 1.0, Flash Player 9, Flash Lite 4

Skickas när alla mottagna data har avkodats och placerats i egenskapen data i URLLoader-objektet. Alla mottagna data är tillgängliga efter att denna händelse har skickats.

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.

Relaterade API-element

URLLoader.load()

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 1.0, AIR 1.0, Flash Lite 4

Skickas om ett anrop till metoden load() försöker få tillgång till data via HTTP och Adobe AIR kan identifiera och returnera statuskoden för begäran.

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.

Relaterade API-element

load()

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 1.0, Flash Player 9, Flash Lite 4

Skickas när ett anrop till URLLoader.load() försöker komma åt data via HTTP. Den här händelsen skickas endast för innehåll som körs i Flash Player om den aktuella Flash Player-miljön upptäcker och returnerar statuskoden för begäran. (I vissa webbläsarmiljöer kanske den här informationen inte kan returneras.) Observera att eventuell httpStatus-händelse skickas före (och utöver) händelserna complete och error.

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.

Relaterade API-element

URLLoader.load()

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 1.0, Flash Player 9, Flash Lite 4

Skickas om ett anrop till URLLoader.load() resulterar i ett allvarligt fel som gör att nedladdningen avbryts.

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.

Relaterade API-element

URLLoader.load()

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 1.0, Flash Player 9, Flash Lite 4

Skickas när nedladdningen påbörjas efter anropet till metoden URLLoader.load().

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.

Relaterade API-element

URLLoader.load()

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 1.0, Flash Player 9, Flash Lite 4

Skickas när data tas emot under nedladdningsförloppet.

Observera att med objektet URLLoader går det inte att få åtkomst till data förrän allt har tagits emot. Händelseförloppet fungerar som en avisering om hur nedladdningen genomförs. Använd objektet AVURLStream om du behöver komma åt data innan nedladdningen är slutförd.

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.

Relaterade API-element

URLLoader.load()

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 1.0, Flash Player 9, Flash Lite 4

Skickas när ett anrop till URLLoader.load() försöker läsa in data från en server utanför säkerhetssandlådan. Skickas också om ett anrop till URLLoader.load() försöker att läsa in en SWZ-fil och certifikatet är ogiltigt eller sammanfattningsfilen inte matchar komponenten.

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.

Relaterade API-element

URLLoader.load()

Juridiska meddelanden | Onlinesekretesspolicy

AVURLLoader - AS3

Paketx

Språkelement

Bilagor

Paket flash.media

cookieHeader

AVURLLoader

addEventListener

close

load

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError