AVURLLoader

Paket	flash.media
Sınıf	public class AVURLLoader
Miras Alma	AVURLLoader URLLoader EventDispatcher Object

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

URLLoader sınıfı bir URL'den metin, ikili veri veya URL olarak kodlanmış değişkenler olarak veri indirir. Dinamik bir veri tabalı uygulamada kullanılacak metin dosyalarını, XML veya diğer bilgileri indirmek için kullanılabilir.

Uygulamalardaki kod tarafından kullanılabilir hale gelmeden önce URLLoader nesnesi bir URL'den tüm verileri indirir. İndirme işlemindeki ilerleme hakkında bildirimler gönderir. Bu bildirimleri bytesLoaded ve bytesTotal özelliklerinin yanı sıra gönderilen olaylar üzerinden izleyebilirsiniz.

FLV'ler gibi çok büyük video dosyaları yüklenirken, bellek dolu hataları oluşabilir.

Bu sınıfı, uygulama güvenlik sanal alanı dışındaki güvenlik sanal alanlarında yer alan Flash Player ve AIR uygulaması içeriği için kullandığınızda, aşağıdaki güvenlik modelini dikkate alın:

Dosya sistemine sahip yerel sanal alandaki bir SWF dosyası, ağ sanal alanındaki bir kaynaktan veya ağ sanal alanındaki bir kaynağa veri yükleyemeyebilir.
Varsayılan olarak, çağıran SWF dosyası ve yüklediğiniz URL tamamen aynı etki alanında olmalıdır. Örneğin www.adobe.com adresindeki bir SWF dosyası yalnızca www.adobe.com adresinde bulunan kaynaklardan veri yükleyebilir. Farklı bir etki alanından veri yüklemek için, verileri barındıran sunucuya bir URL ilke dosyası yerleştirin.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

İlgili API Öğeleri

URLRequest
URLVariables
AVURLStream

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		bytesLoaded : uint = 0 Yükleme sırasında şimdiye kadar gönderilen bayt sayısını gösterir.	URLLoader
		bytesTotal : uint = 0 İndirilen verideki toplam bayt sayısını gösterir.	URLLoader
		constructor : Object Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	Object
		cookieHeader : String [salt yazılır]	AVURLLoader
		data : * Yükleme işleminden alınan veriler.	URLLoader
		dataFormat : String = "text" İndirilen veri metin olarak mı (URLLoaderDataFormat.TEXT), ham ikili veri mi (URLLoaderDataFormat.BINARY) yoksa URL kodlamalı değişkenler olarak mı (URLLoaderDataFormat.VARIABLES) alınıyor, kontrol eder.	URLLoader

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		AVURLLoader(request:URLRequest = null) Bir URLLoader nesnesi oluşturur.	AVURLLoader
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [geçersiz kıl]	AVURLLoader
		close():void [geçersiz kıl] İlerlemekte olan yükleme işlemini kapatır.	AVURLLoader
		dispatchEvent(event:Event):Boolean Olay akışına bir olay gönderir.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.	EventDispatcher
		hasOwnProperty(name:String):Boolean Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.	Object
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		load(request:URLRequest):void [geçersiz kıl] Belirtilen URL'ye veri gönderip yükler.	AVURLLoader
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher nesnesinden bir dinleyiciyi kaldırır.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String Belirtilen nesnenin dize olarak temsil edilen halini döndürür.	Object
		valueOf():Object Belirtilen nesnenin temel değerini döndürür.	Object
		willTrigger(type:String):Boolean Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder.	EventDispatcher

Olaylar

Olaylarla ilgili daha fazla bilgi için tıklatın

Miras Alınan Olayları Gizle

Miras Alınan Olayları Göster

	Özet	Tanımlayan:
activate	[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.	EventDispatcher
complete	Alınan tüm verilerin kodu çözüldükten ve URLLoader nesnesinin data özelliğine yerleştirildikten sonra gönderilir.	AVURLLoader
deactivate	[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.	EventDispatcher
httpResponseStatus	load() yöntemine yapılan bir çağrı HTTP üzerinden verilere erişmeye çalışıyorsa ve Adobe AIR, istek için durum kodunu algılayıp döndürebiliyorsa gönderilir.	AVURLLoader
httpStatus	URLLoader.load() yöntemine yapılan bir çağrı HTTP üzerinden verilere erişmeye çalışıyorsa gönderilir.	AVURLLoader
ioError	URLLoader.load() öğesine yapılan bir çağrı, indirme işlemini sonlandıran kritik bir hatayla sonuçlanırsa gönderilir.	AVURLLoader
open	URLLoader.load() yöntemine yapılan bir çağrıyı izleyen indirme işlemi başladığında gönderilir.	AVURLLoader
progress	İndirme işlemi ilerlerken veri alındığında gönderilir.	AVURLLoader
securityError	URLLoader.load() öğesine yapılan bir çağrı, güvenlik sanal alanının dışındaki bir sunucudan veri yüklemeye çalıştığında gönderilir.	AVURLLoader

Özellik Ayrıntısı

cookieHeader

özellik

cookieHeader:String [salt yazılır]

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

Yapıcı Ayrıntı

()

Yapıcı

public function AVURLLoader(request:URLRequest = null)

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Bir URLLoader nesnesi oluşturur.

Parametreler

request:URLRequest (default = null) — İndirilecek URL'yi belirten bir URLRequest nesnesi. Bu parametre atlanırsa herhangi bir yükleme işlemi başlamaz. Belirtilmişse, yükleme işlemi hemen başlar. (Daha fazla bilgi için load girişine bakın.)

İlgili API Öğeleri

URLLoader.load()

Yöntem Ayrıntısı

addEventListener

()

yöntem

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

Parametreler

	`type:String`

	`listener:Function`

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

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

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

close

()

yöntem

override public function close():void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Devam etmekte olan yükleme işlemini kapatır. Devam etmekte olan herhangi bir yükleme işlemi hemen sonlandırılır. Herhangi bir URL o anda akıştaysa, geçersiz bir akış hatası verilir.

load

()

yöntem

override public function load(request:URLRequest):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Belirtilen URL'ye veri gönderir ve buradan veri yükler. Veriler dataFormat özelliği için ayarladığınız değere bağlı olarak metin, ham ikili veriler veya URL kodlu değişkenler şeklinde alınabilir. dataFormat özelliğinin varsayılan ayarının metin olduğunu unutmayın. Verileri belirtilen URL'ye göndermek isterseniz, URLRequest nesnesindeki data özelliğini ayarlayabilirsiniz.

Not: İndirilen bir dosya ASCII olmayan karakterler içeriyorsa (İngilizce dışındaki birçok dilde görüldüğü gibi) dosyayı, ASCII gibi Unicode olmayan bir biçimin aksine UTF-8 veya UTF-16 kodlamasıyla kaydetmeniz önerilir.

Dosya sistemine sahip yerel sanal alandaki bir SWF dosyası, ağ sanal alanındaki bir kaynaktan veya ağ sanal alanındaki bir kaynağa veri yükleyemeyebilir.

Varsayılan olarak, çağıran SWF dosyası ve yüklediğiniz URL tamamen aynı etki alanında olmalıdır. Örneğin www.adobe.com adresindeki bir SWF dosyası yalnızca www.adobe.com adresinde bulunan kaynaklardan veri yükleyebilir. Farklı bir etki alanından veri yüklemek için, verileri barındıran sunucuya bir URL ilke dosyası yerleştirin.

Ortak olarak ayrılmış bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.

Flash Player 10 ve sonrasında, yükleme (POST gövdesi içinde "content-disposition" başlığında "filename" parametresiyle belirtilir) içeren çok bölümlü bir Content-Type (örneğin, "multipart/form-data") kullanırsanız, POST işlemi, yüklemelere uygulanan güvenlik kurallarına tabidir:

Fare tıklatma veya tuş basışı gibi kullanıcı tarafından başlatılan bir eyleme yanıt olarak POST işleminin gerçekleştirilmesi gerekir.
POST işlemi etki alanları arasıysa (POST hedefi, POST isteğini gönderen SWF dosyasıyla aynı sunucuda değilse), hedef sunucunun etki alanları arası erişime izin veren bir URL ilke dosyası sağlaması gerekir.

Ayrıca çok bölümlü herhangi bir Content-Type için sözdiziminin geçerli olması gerekir (RFC2046 standartlarına göre). Sözdizimi geçersiz görünüyorsa, POST işlemi, yüklemelere uygulanan güvenlik kurallarına tabi olur.

Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Parametreler

request:URLRequest — İndirilecek URL'yi belirten bir URLRequest nesnesi.

Olaylar

	`complete:Event` — Veriler başarılı şekilde yüklendikten sonra gönderilir.

	`httpStatus:HTTPStatusEvent` — HTTP üzerinden erişim gerçekleşirse ve geçerli Flash Player ortamı durum kodlarını almayı desteklerse, bir `complete` veya `error` olayının yanı sıra bu olayları alabilirsiniz.

	`ioError:IOErrorEvent` — Yükleme işlemi tamamlanamadı.

	`progress:ProgressEvent` — İndirme işlemi ilerlerken veri alındığında gönderilir.

	`securityError:SecurityErrorEvent` — Bir yükleme işlemi, arayanın güvenlik sanal alanının dışındaki bir sunucudan veri almaya çalıştı. Bu sorun, sunucu üzerinde bir ilke dosyası kullanarak çözülebilir.

	`securityError:SecurityErrorEvent` — Bir yükleme işlemi SWZ dosyasını (bir Adobe platformu bileşeni) yüklemeyi denemiştir ancak sertifika geçersizdir veya özet bileşenle eşleşmez.

	`open:Event` — Bir yükleme işlemi başladığında gönderilir.

	`httpResponseStatus:HTTPStatusEvent` — `load()` yöntemine yapılan bir çağrı HTTP üzerinden verilere erişmeye çalışıyorsa ve Adobe AIR, istek için durum kodunu algılayıp döndürebiliyorsa gönderilir.

Atar

	`ArgumentError` — `URLRequest.requestHeader` nesneleri yasaklanmış belirli HTTP istek üstbilgilerini içermeyebilir. Daha fazla bilgi için, URLRequestHeader sınıfı açıklamasına bakın.

	`MemoryError` — Bu hata şu nedenlerin birinden ötürü meydana gelebilir: 1) Flash Player veya AIR, `URLRequest.data` parametresini UTF8'den MBCS'ye dönüştüremiyordur. Bu hata, `load()` öğesine iletilen URLRequest nesnesinin bir `GET` işlemi gerçekleştirecek şekilde ayarlanması ve `System.useCodePage` öğesinin `true` olarak ayarlanması durumunda ortaya çıkabilir. 2) Flash Player veya AIR, `POST` verileri için bellek ayıramıyor. Bu hata, `load` öğesine iletilen URLRequest nesnesinin bir `POST` işlemi gerçekleştirecek şekilde ayarlanması durumunda meydana gelebilir.

	`SecurityError` — Güvenilmeyen yerel dosyalar İnternet ile iletişim kuramayabilir. Bu sorun dosyanın ağ iletişimi olan yerel veya güvenilir olarak yeniden sınıflandırılmasıyla çözülebilir.

	`SecurityError` — Ortak olarak ayrılmış bir bağlantı noktasına bağlanmayı deniyorsunuzdur. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.

	`TypeError` — request parametresinin veya iletilen URLRequest nesnesinin `URLRequest.url` özelliği `null` şeklindedir.

İlgili API Öğeleri

URLRequestHeader
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest

Olay Ayrıntısı

complete

Olay

Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.COMPLETE

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Alınan tüm verilerin kodu çözüldükten ve URLLoader nesnesinin data özelliğine yerleştirildikten sonra gönderilir. Alınan verilere bu olay gönderildiğinde erişilebilir.

Event.COMPLETE sabiti, complete olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`target`	Yüklemesi tamamlanan network nesnesi.

İlgili API Öğeleri

URLLoader.load()

httpResponseStatus

Olay

Olay Nesne Türü: flash.events.HTTPStatusEvent
özellik HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, AIR 1.0, Flash Lite 4

load() yöntemine yapılan bir çağrı HTTP üzerinden verilere erişmeye çalışıyorsa ve Adobe AIR, istek için durum kodunu algılayıp döndürebiliyorsa gönderilir.

httpStatus olayından farklı olarak, httpResponseStatus olayı herhangi bir yanıt verisinden önce teslim edilir. Ayrıca, httpResponseStatus olayı, responseHeaders ve responseURL özelliklerine yönelik değerleri (httpStatus olayı için tanımsızdır) içerir. httpResponseStatus olayının (varsa) herhangi bir complete veya error olayından önce (ve buna ek olarak) gönderileceğini unutmayın.

HTTPStatusEvent.HTTP_RESPONSE_STATUS sabiti, httpResponseStatus olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`responseURL`	Yanıtın döndürüldüğü URL.
`responseHeaders`	URLRequestHeader nesneleri dizisi olarak yanıtın döndürüldüğü yanıt üstbilgileri.
`status`	Sunucudan gelen HTTP durum kodu.
`redirected`	Yanıtın yeniden yönlendirme sonucu olup olmadığıyla ilgilidir.
`target`	HTTP durum kodunu alan network nesnesi.

İlgili API Öğeleri

load()

httpStatus

Olay

Olay Nesne Türü: flash.events.HTTPStatusEvent
özellik HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

URLLoader.load() yöntemine yapılan bir çağrı HTTP üzerinden verilere erişmeye çalışıyorsa gönderilir. Flash Player'da çalışan içerik için, bu olay yalnızca geçerli Flash Player ortamı isteğe ilişkin durum kodunu algılayıp döndürebiliyorsa gönderilir. (Bazı tarayıcı ortamları, bu bilgiyi sağlayamayabilir.) httpStatus olayının (varsa) herhangi bir complete veya error olayından önce (veya buna ek olarak) gönderileceğini unutmayın.

HTTPStatusEvent.HTTP_STATUS sabiti, httpStatus olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`status`	Sunucudan gelen HTTP durum kodu.
`target`	HTTP durum kodunu alan network nesnesi.

İlgili API Öğeleri

URLLoader.load()

ioError

Olay

Olay Nesne Türü: flash.events.IOErrorEvent
özellik IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

URLLoader.load() öğesine yapılan bir çağrı, indirme işlemini sonlandıran kritik bir hatayla sonuçlanırsa gönderilir.

ioError olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`errorID`	Belirli bir hata mesajıyla ilişkili başvuru numarası (yalnızca AIR).
`target`	Girdi/çıktı hatası yaşayan network nesnesi.
`text`	Hata mesajı olarak gösterilecek metin.

İlgili API Öğeleri

URLLoader.load()

open

Olay

Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.OPEN

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

URLLoader.load() yöntemine yapılan bir çağrıyı izleyen indirme işlemi başladığında gönderilir.

Event.OPEN sabiti, open olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`target`	Bağlantıyı açan network nesnesi.

İlgili API Öğeleri

URLLoader.load()

progress

Olay

Olay Nesne Türü: flash.events.ProgressEvent
özellik ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

İndirme işlemi ilerlerken veri alındığında gönderilir.

Bir URLLoader nesnesi kullanılarak, verilerin tamamı alınana kadar bu verilere erişemeyeceğinizi unutmayın. Bu nedenle, ilerleme olayı yalnızca indirme işleminin ne kadar ilerlediğini gösteren bir bildirim görevi görür. Verilerin tamamı indirilmeden önce verilere erişmek için bir AVURLStream nesnesi kullanın.

Bir progress olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`bytesLoaded`	Dinleyici olayı işlerken yüklenen öğe veya bayt sayısı.
`bytesTotal`	Yükleme işlemi başarılı olursa yüklenecek toplam öğe veya bayt sayısı.
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`target`	İlerlemeyi bildiren nesne.

İlgili API Öğeleri

URLLoader.load()

securityError

Olay

Olay Nesne Türü: flash.events.SecurityErrorEvent
özellik SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

URLLoader.load() öğesine yapılan bir çağrı, güvenlik sanal alanının dışındaki bir sunucudan veri yüklemeye çalıştığında gönderilir. Ayrıca URLLoader.load() öğesine yapılan bir çağrı, SWZ dosyasını yüklemeye çalıştığında ve sertifika geçersiz olduğunda veya özet dizesi bileşenle eşleşmediğinde gönderilir.

SecurityErrorEvent.SECURITY_ERROR sabiti, securityError olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`target`	Güvenlik hatasını bildiren network nesnesi.
`text`	Hata mesajı olarak gösterilecek metin.

İlgili API Öğeleri

URLLoader.load()

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

AVURLLoader - AS3

Sınıflar x

cookieHeader

AVURLLoader

addEventListener

close

load

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError