AVURLLoader

Pakket	flash.media
Klasse	public class AVURLLoader
Overerving	AVURLLoader URLLoader EventDispatcher Object

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

De klasse URLLoader downloadt gegevens via een URL, zoals tekst, binaire gegevens of URL-gecodeerde variabelen. Dit is nuttig om tekstbestanden, XML of andere informatie te downloaden die moet worden gebruikt in een dynamische toepassing die met gegevens werkt.

Een URLLoader-object downloadt alle gegevens van een URL voordat deze aan de toepassingen beschikbaar worden gesteld. Er worden meldingen verzonden over de voortgang van de download, die u kunt via de eigenschappen bytesLoaded en bytesTotal en via verzonden gebeurtenissen kunt controleren.

Bij het laden van zeer grote videobestanden, bijvoorbeeld FLV-bestanden, kunnen fouten met betrekking tot te weinig geheugen optreden.

Wanneer u deze klasse gebruikt in Flash Player en in inhoud in een AIR-toepassing in andere beveiligingssandboxen dan de sandbox met toepassingsbeveiliging, moet u het volgende beveiligingsmodel overwegen:

Een SWF-bestand in de sandbox Lokaal-met-bestandssysteem kan geen gegevens laden naar een bron in de netwerksandbox of deze bron van gegevens voorzien.
Standaard moeten het aanroepende SWF-bestand en de URL die u laadt zich in exact hetzelfde domein bevinden. Een SWF-bestand op www.adobe.com kan bijvoorbeeld alleen gegevens laden van bronnen die zelf ook aanwezig zijn op www.adobe.com. Wanneer u gegevens van een ander domein wilt laden, plaatst u een bestand met URL-beleid op de server die als host fungeert voor de gegevens.

Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.

Verwante API-elementen

URLRequest
URLVariables
AVURLStream

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		bytesLoaded : uint = 0 Geeft het aantal bytes aan dat tot nu toe tijdens de laadbewerking is geladen.	URLLoader
		bytesTotal : uint = 0 Geeft het totale aantal bytes in de gedownloade gegevens aan.	URLLoader
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		cookieHeader : String [alleen-schrijven]	AVURLLoader
		data : * De gegevens die via de laadbewerking zijn ontvangen.	URLLoader
		dataFormat : String = "text" Houdt bij of de gedownloade gegevens als tekst (URLLoaderDataFormat.TEXT), als onbewerkte binaire gegevens (URLLoaderDataFormat.BINARY) of als URL-gecodeerde variabelen (URLLoaderDataFormat.VARIABLES) zijn ontvangen.	URLLoader

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		AVURLLoader(request:URLRequest = null) Maakt een object URLLoader.	AVURLLoader
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [overschrijven]	AVURLLoader
		close():void [overschrijven] Sluit de laadbewerking die wordt uitgevoerd.	AVURLLoader
		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
		load(request:URLRequest):void [overschrijven] Verzendt en laadt gegevens via de opgegeven URL.	AVURLLoader
		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
		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 nadat alle ontvangen gegevens zijn gedecodeerd en in de gegevenseigenschap van het object URLLoader zijn geplaatst.	AVURLLoader
deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	EventDispatcher
httpResponseStatus	Wordt verzonden als een aanroep naar de methode load() via HTTP toegang tot gegevens probeert te krijgen, en Adobe AIR de statuscode voor de aanvraag kan detecteren en retourneren.	AVURLLoader
httpStatus	Wordt verzonden als een aanroep naar URLLoader.load() via HTTP toegang probeert te krijgen tot gegevens.	AVURLLoader
ioError	Wordt verzonden wanneer een aanroep naar URLLoader.load() resulteert in een fatale fout die de download beëindigt.	AVURLLoader
open	Wordt verzonden wanneer de downloadbewerking begint na een aanroep van de methode URLLoader.load().	AVURLLoader
progress	Wordt verzonden wanneer gegevens tijdens de downloadbewerking worden ontvangen.	AVURLLoader
securityError	Wordt verzonden wanneer een aanroep naar URLLoader.load() probeert gegevens te laden van een server buiten de beveiligingssandbox.	AVURLLoader

Eigenschapdetails

cookieHeader

eigenschap

cookieHeader:String [alleen-schrijven]

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

Constructordetails

()

Constructor

public function AVURLLoader(request:URLRequest = null)

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Maakt een object URLLoader.

Parameters

request:URLRequest (default = null) — Een object URLRequest dat de URL opgeeft die moet worden gedownload. Wanneer deze parameter wordt weggelaten, begint de laadbewerking niet. Wanneer de parameter wordt opgegeven, begint de laadbewerking direct (zie load voor meer informatie).

Verwante API-elementen

URLLoader.load()

Methodedetails

addEventListener

()

methode

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

Parameters

	`type:String`

	`listener:Function`

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

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

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

close

()

methode

override public function close():void

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Sluit de laadbewerking die wordt uitgevoerd. Een eventuele laadbewerking die wordt uitgevoerd, wordt direct beëindigd. Wanneer momenteel geen URL wordt gestreamd, wordt een fout met betrekking tot een ongeldige stream gegenereerd.

load

()

methode

override public function load(request:URLRequest):void

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Verzendt en laadt gegevens via de opgegeven URL. De gegevens kunnen worden ontvangen als tekst, onbewerkte binaire gegevens of URL-gecodeerde variabelen, afhankelijk van de waarde die u voor de eigenschap dataFormat instelt. De standaardwaarde van de eigenschap dataFormat is tekst. Wanneer u gegevens naar de opgegeven URL wilt verzenden, kunt u de eigenschap data in het object URLRequest instellen.

Opmerking: wanneer een bestand dat wordt geladen niet-ASCII-tekens bevat (zoals in vele niet-Engelse talen), wordt geadviseerd het bestand met UTF-8- of UTF-16-codering op te slaan in plaats van een niet-Unicode-indeling zoals ASCII.

Een SWF-bestand in de sandbox Lokaal-met-bestandssysteem kan geen gegevens laden naar een bron in de netwerksandbox of deze bron van gegevens voorzien.

Standaard moeten het aanroepende SWF-bestand en de URL die u laadt zich in exact hetzelfde domein bevinden. Een SWF-bestand op www.adobe.com kan bijvoorbeeld alleen gegevens laden van bronnen die zelf ook aanwezig zijn op www.adobe.com. Wanneer u gegevens van een ander domein wilt laden, plaatst u een bestand met URL-beleid op de server die als host fungeert voor de gegevens.

U kunt geen verbinding maken met algemeen gereserveerde poorten. Zie "Netwerk-API's beperken" in de Adobe ActionScript 3.0-ontwikkelaarsgids voor een volledige lijst van geblokkeerde poorten.

Als u in Flash Player 10 en hoger een multipart-inhoudstype gebruikt (bijvoorbeeld 'multipart/form-data') dat een upload bevat (aangegeven met de parameter 'bestandsnaam' in een header 'content-disposition' binnen de POST-body), gelden voor de POST-bewerking de beveiligingsregels die van toepassing zijn op uploads:

De POST-bewerking moet worden uitgevoerd in reactie op een door de gebruiker geïnitieerde actie, zoals het klikken met de muis of het indrukken van een toets.
Als bij de POST-bewerking verschillende domeinen betrokken zijn (het doel van de POST-bewerking bevindt zich niet op dezelfde server als het SWF-bestand dat de POST-aanvraag verstuurt), moet de doelserver een URL-beleidsbestand leveren dat interdomeintoegang toestaat.

In het geval van een multipart-inhoudstype is het ook essentieel dat de syntaxis juist is (in overeenstemming met de norm RFC2046). Als de syntaxis ongeldig lijkt te zijn, gelden voor de POST-bewerking de beveiligingsregels die van toepassing zijn op uploads.

Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.

Parameters

request:URLRequest — Een object URLRequest dat de URL opgeeft die moet worden gedownload.

Gebeurtenissen

	`complete:Event` — Wordt verzonden nadat gegevens zijn geladen.

	`httpStatus:HTTPStatusEvent` — Wanneer toegang plaatsvindt via HTTP en de huidige Flash Player-omgeving het ophalen van statuscodes ondersteunt, kunt u deze gebeurtenissen ontvangen naast de gebeurtenissen `complete`of `error`.

	`ioError:IOErrorEvent` — De laadbewerking kan niet worden voltooid.

	`progress:ProgressEvent` — Wordt verzonden wanneer gegevens tijdens de downloadbewerking worden ontvangen.

	`securityError:SecurityErrorEvent` — Een laadbewerking probeerde gegevens op te halen van een server buiten de beveiligingssandbox van de aanroeper. Dit kan worden omzeild door gebruik te maken van een beleidsbestand op de server.

	`securityError:SecurityErrorEvent` — Er is geprobeerd een SWZ-bestand (een component van het Adobe-platform) te laden, maar het certificaat is ongeldig of de digest-tekenreeks komt niet overeen met de component.

	`open:Event` — Wordt verzonden wanneer een laadbewerking begint.

	`httpResponseStatus:HTTPStatusEvent` — Wordt verzonden als een aanroep naar de methode `load()` via HTTP toegang tot gegevens probeert te krijgen en Adobe AIR de statuscode voor de aanvraag kan detecteren en retourneren.

Gegenereerde uitzondering

	`ArgumentError` — Objecten `URLRequest.requestHeader` mogen bepaalde niet-toegestane HTTP-aanvraagheaders niet bevatten. Zie de beschrijving van de klasse URLRequestHeader voor meer informatie.

	`MemoryError` — Deze fout kan om de volgende redenen optreden: 1) Flash Player of AIR kan de parameter `URLRequest.data` niet converteren van UTF8 naar MBCS. Deze fout treedt op wanneer het object URLRequest dat aan `load()` is doorgegeven, een bewerking `GET` uitvoert en wanneer `System.useCodePage` op `true` is ingesteld. 2) Flash Player of AIR kan geen geheugen toewijzen voor de `POST`-gegevens. Deze fout doet zich voor wanneer het object URLRequest dat aan `load` wordt doorgegeven, een bewerking `POST` uitvoert.

	`SecurityError` — Lokale niet-vertrouwde bestanden mogen niet communiceren met internet. U kunt dit omzeilen door dit bestand opnieuw te classificeren als lokaal-met-netwerk of vertrouwd.

	`SecurityError` — U probeert verbinding te maken met een algemeen gereserveerde poort. Zie "Netwerk-API's beperken" in de Adobe ActionScript 3.0-ontwikkelaarsgids voor een volledige lijst van geblokkeerde poorten.

	`TypeError` — De waarde van de parameter request of de eigenschap `URLRequest.url` van het doorgegeven object URLRequest is `null`.

Verwante API-elementen

URLRequestHeader
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest

Gebeurtenisdetails

complete

Gebeurtenis

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Wordt verzonden nadat alle ontvangen gegevens zijn gedecodeerd en in de gegevenseigenschap van het object URLLoader zijn geplaatst. De ontvangen gegevens zijn toegankelijk nadat deze gebeurtenis is verzonden.

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.

Verwante API-elementen

URLLoader.load()

httpResponseStatus

Gebeurtenis

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, AIR 1.0, Flash Lite 4

Wordt verzonden als een aanroep naar de methode load() via HTTP toegang tot gegevens probeert te krijgen, en Adobe AIR de statuscode voor de aanvraag kan detecteren en retourneren.

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.

Verwante API-elementen

load()

httpStatus

Gebeurtenis

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Wordt verzonden als een aanroep naar URLLoader.load() via HTTP toegang probeert te krijgen tot gegevens. Voor inhoud die in Flash Player wordt uitgevoerd, wordt deze gebeurtenis alleen verzonden als de huidige Flash Player-omgeving de statuscode voor de aanvraag kan detecteren en retourneren. (Sommige browseromgevingen kunnen deze informatie mogelijk niet bieden.) De gebeurtenis httpStatus (indien aanwezig) wordt verzonden voor (en als aanvulling op) een eventuele gebeurtenis complete of error.

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.

Verwante API-elementen

URLLoader.load()

ioError

Gebeurtenis

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Wordt verzonden wanneer een aanroep naar URLLoader.load() resulteert in een fatale fout die de download beëindigt.

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.

Verwante API-elementen

URLLoader.load()

open

Gebeurtenis

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Wordt verzonden wanneer de downloadbewerking begint na een aanroep van de methode URLLoader.load().

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.

Verwante API-elementen

URLLoader.load()

progress

Gebeurtenis

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Wordt verzonden wanneer gegevens tijdens de downloadbewerking worden ontvangen.

Let op dat in het geval van een object URLLoader de gegevens pas toegankelijk zijn nadat alle gegevens volledig zijn ontvangen. ProgressEvent fungeert daarom slechts als melding van de voortgang van de download. Wanneer u toegang wilt tot de gegevens voordat deze volledig zijn gedownload, gebruikt u het object AVURLStream.

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.

Verwante API-elementen

URLLoader.load()

securityError

Gebeurtenis

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Wordt verzonden wanneer een aanroep naar URLLoader.load() probeert gegevens te laden van een server buiten de beveiligingssandbox. Wordt ook verzonden wanneer een aanroep van URLLoader.load() probeert een SWZ-bestand te laden en het certificaat ongeldig is of de digest-tekenreeks niet overeenkomt met de component.

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.

Verwante API-elementen

URLLoader.load()

Juridische kennisgeving | Online privacybeleid

AVURLLoader - AS3

Pakkettenx

Taalelementen

Bijlagen

Pakket flash.media

cookieHeader

AVURLLoader

addEventListener

close

load

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError