URLFilePromise

Paket	air.desktop
Sınıf	public class URLFilePromise
Miras Alma	URLFilePromise EventDispatcher Object
Uygular	IFilePromise

Dil Sürümü:

ActionScript 3.0

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

AIR 2.0

URLFilePromise sınıfı, bir URL'de erişilebilen kaynakların AIR uygulamasından bir dosya izni olarak sürüklenmesine olanak sağlar.

URLFilePromise sınıfı, veri kaynağı olarak URLStream ve URLRequest nesnelerini kullanarak IFilePromise arabirimini uygular. Uygulama, HTTP veya URLStream sınıfının desteklediği diğer protokoller kullanılarak alınabilen dosyalar için sürükleyip bırakma desteği sağlar.

Bir URL dosya izni oluşturmak için:

Bir veya daha fazla URLFilePromise nesnesi oluşturup başlatın.
URLFilePromise nesnelerini bir diziye ekleyin.
FILE_PROMISE_LIST ClipboardFormat öğesini kullanarak diziyi yeni bir Clipboard nesnesine ekleyin.
Bir kullanıcı hareketine yanıt olarak, NativeDragManager startDrag() yöntemini çağırıp dosya izinleri dizisini içeren Clipboard nesnesini iletin.

Kullanıcı sürükleme işlemini tamamladığında, çalışma zamanı her dosya izni için verileri indirir. URLFilePromise nesnesinin request özelliği tarafından belirtilen URL'de verilere erişilir ve bu veriler relativePath özelliğinde belirtilen dosyaya kaydedilir. Dosya, bırakma konumuna göre kaydedilir. Bu nedenle, ilgili yol foo/bar.txt ise ve dosya izni home adındaki bir klasöre bırakılırsa, oluşturulan dosyanın konumu home/foo/bar.txt olur. Bir hata oluşursa, dosya oluşturulmaz.

URLStream sınıfı üzerinden erişilemeyen veri kaynaklarını desteklemek için IFilePromise arabirimini uygulayın.

Not: AIR çalışma zamanı otomatik olarak open(), close() ve reportError() IFilePromise yöntemlerini çağırır. Bu yöntemler hiçbir zaman uygulama mantığınız tarafından çağrılmamalıdır. Aynı şekilde, bu URLFilePromise nesnesi tarafından gönderilen open, progress, complete ve close olayları da birincil olarak hata ayıklama amaçlarıyla sağlanır. Uygulamanızın bu olaylara yanıt vermesi gerekmez.

Bu sınıf aircore.swc dosyasına dahildir. Adobe^® AIR^™ için bir proje oluşturduğunuzda, Adobe^® Flash^™ Builder bu sınıfı otomatik olarak yükler. Adobe^® Flex^™ SDK, bu aircore.swc dosyasını da içerir. Flex SDK kullanıyorsanız uygulamayı derlerken bu dosyayı dahil etmeniz gerekir.

Adobe^® Flash^® Professional'da (CS4 veya üstü) air.desktop paketini kullanmak için:

Dosya > Yayınlama Ayarları komutunu seçin.
Flash panelinde, ActionScript 3.0 için Ayarlar düğmesini tıklatın. Kütüphane Yolu'nu seçin.
SWC Dosyasına Git düğmesini tıklatın. Adobe Flash Professional yükleme klasöründeki Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc dosyasına gidin.
Tamam düğmesini tıklatın.
Aşağıdaki import ifadesini ActionScript 3.0 kodunuza ekleyin: import air.desktop.*;

İlgili API Öğeleri

IFilePromise arabirimi
Clipboard sınıfı
ClipboardFormats sınıfı
NativeDragManager sınıfı
URLStream sınıfı
URLRequest sınıfı

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		constructor : Object Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	Object
		isAsync : Boolean [salt okunur] Kaynak verilerinin eşzamansız olarak kullanılıp kullanılamadığını belirtir.	URLFilePromise
		relativePath : String Oluşturulan dosyanın, bırakma hedefine göre yolu ve dosya adı.	URLFilePromise
		request : URLRequest Sürükleyip bırakma işleminin sonucunda kopyalanacak kaynağı tanımlayan URLRequest öğesi.	URLFilePromise

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		URLFilePromise() Bir URLFilePromise nesnesi oluşturur.	URLFilePromise
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder.	EventDispatcher
		close():void AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında uygun zamanda veri kaynağını kapatmasına olanak sağlar.	URLFilePromise
		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
		open():IDataInput AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında uygun zamanda veri kaynağını açmasına olanak sağlar.	URLFilePromise
		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
		reportError(e:ErrorEvent):void AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında oluşan hataları bildirmesine olanak sağlar.	URLFilePromise
		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	Dosya için veriler tamamen indirildiğinde gönderilir.	URLFilePromise
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	Yanıt üstbilgilerini bildirmek üzere HTTP istekleri için gönderilir.	URLFilePromise
httpStatus	İstek durum kodunu bildirmek üzere HTTP istekleri için gönderilir.	URLFilePromise
ioError	Bir IOError öğesi dosya indirmeyi önlediğinde gönderilir.	URLFilePromise
open	Temel URLStream bağlantısı açıldığında gönderilir.	URLFilePromise
progress	Bir veri bloğu, temel URLStream öğesinden okunabilir olduğunda gönderilir.	URLFilePromise
securityError	Bir güvenlik hatası dosya indirmeyi önlediğinde gönderilir.	URLFilePromise

Özellik Ayrıntısı

isAsync

özellik

isAsync:Boolean [salt okunur]

Dil Sürümü:

ActionScript 3.0

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

AIR 2.0

Kaynak verilerinin eşzamansız olarak kullanılıp kullanılamadığını belirtir.

URL akışları esas olarak eşzamansız olduğundan, URLFilePrmise nesnesinin isAsync özelliği her zaman true olur.

Uygulama
public function get isAsync():Boolean

relativePath

özellik

relativePath:String

Dil Sürümü:

ActionScript 3.0

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

AIR 2.0

Oluşturulan dosyanın, bırakma hedefine göre yolu ve dosya adı.

Yol, bırakma konumuna göre çözümlenen alt dizinler içerebilir. Gerekirse alt dizinler oluşturulur. Alt dizinleri dahil ederken, geçerli işletim sistemi için uygun yol ayırıcı karakterini eklemek üzere File.separator sabitini kullanın. Üst dizine gitmek için .. kısayolunun kullanılmasına izin verilmez.

Dosya adının, uzak kaynağın dosya adıyla aynı olması gerekmez.

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

request

özellik

request:URLRequest

Dil Sürümü:

ActionScript 3.0

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

AIR 2.0

Sürükleyip bırakma işleminin sonucunda kopyalanacak kaynağı tanımlayan URLRequest öğesi.

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

Yapıcı Ayrıntı

()

Yapıcı

public function URLFilePromise()

Dil Sürümü:

ActionScript 3.0

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

AIR 2.0

Bir URLFilePromise nesnesi oluşturur.

Bu URLFilePromise nesnesini kullanmadan önce, request ve relativePath özelliklerini ayarlamanız gerekir.

Yöntem Ayrıntısı

close

()

yöntem

public function close():void

Dil Sürümü:

ActionScript 3.0

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

AIR 2.0

AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında uygun zamanda veri kaynağını kapatmasına olanak sağlar.

Uygulama mantığınızda bu işlemi çağırmayın.

open

()

yöntem

public function open():IDataInput

Dil Sürümü:

ActionScript 3.0

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

AIR 2.0

AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında uygun zamanda veri kaynağını açmasına olanak sağlar.

Uygulama mantığınızda bu işlemi çağırmayın.

Döndürür

IDataInput

reportError

()

yöntem

public function reportError(e:ErrorEvent):void

Dil Sürümü:

ActionScript 3.0

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

AIR 2.0

AIR çalışma zamanının, sürükleyip bırakma işlemi sırasında oluşan hataları bildirmesine olanak sağlar.

URLFilePromise nesnesi, bildirilen tüm hata olaylarını yeniden gönderir. Uygulama mantığınızda bu işlemi çağırmayın.

Parametreler

e:ErrorEvent

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 2.0

Dosya için veriler tamamen indirildiğinde gönderilir.

Not: AIR çalışma zamanı, eşzamansız veri alma işlemini yönetmek için bu olayı kullanır. Genellikle, uygulamanızın bu olaya yanıt olarak herhangi bir eylem uygulaması gerekmez.

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.

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 2.0

Yanıt üstbilgilerini bildirmek üzere HTTP istekleri için 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.

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 2.0

İstek durum kodunu bildirmek üzere HTTP istekleri için gönderilir.

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.

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 2.0

Bir IOError öğesi dosya indirmeyi önlediğinde 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.

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 2.0

Temel URLStream bağlantısı açıldığında gönderilir.

Not: AIR çalışma zamanı, eşzamansız veri alma işlemini yönetmek için bu olayı kullanır. Genellikle, uygulamanızın bu olaya yanıt olarak herhangi bir eylem uygulaması gerekmez.

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.

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 2.0

Bir veri bloğu, temel URLStream öğesinden okunabilir olduğunda gönderilir.

Not: AIR çalışma zamanı, eşzamansız veri alma işlemini yönetmek için bu olayı kullanır. Genellikle, uygulamanızın bu olaya yanıt olarak herhangi bir eylem uygulaması gerekmez.

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.

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 2.0

Bir güvenlik hatası dosya indirmeyi önlediğ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.

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

URLFilePromise - AS3

Paketlerx

Dil Öğeleri

Ekler

Paket air.desktop

isAsync

relativePath

request

URLFilePromise

close

open

reportError

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError