براي استفاده از کلاس FileReference قبل از هر کاري بايد اين کلاس رو import کنيد. کد زير نحوه انجام اين کار رو نشون ميده:
import flash.net.FileReference
حالا براي استفاده از اين کلاس يک شي از اين کلاس مي سازيد.
کد:var FileRef:Object=new FileReference()
خوب ميرسيم به متد هاي اين کلاس :
شما ميتونيد از تابع browse براي نمايش يک پنجره که امکان انتخاب فايل يا سيو فايل رو به کاربر ميده ، استفاده کنيد .
اين تابع يک آرايه رو براي ----- کردن فايل ها دريافت ميکنه.
هر يک از عناصر اين آرايه بايد يک شي با دو خصيصه description و extension داشته باشه . اولي شرحي براي نمايش در browser و دومي هم پسوند هاي فايل هايي که بايد نمايش
داده شود.
مثال :
کد:
FileRef.browse([{description:"TXT Files",extension:"*.txt;*.doc"}])
با اين کار کابر تنها قادر به انتخاب فيل هاي متني txt و doc است
اما زماني که کاربر فايلي رو انتخاب کرد چي؟ چطور بايد از اين اتفاق با خبر شويم؟
متد addListener يک شنودگر ايجاد ميکنه که شما ميتونيد از رويدادهاي مختلف استفاده کنيد اين تابع يک شي رو دريافت ميکنه و شما با استفاده از اون شي ميتونيد به رويداد ها
دسترسي داشته باشيد.
در کد زير نحوه ايجاد يک شنودگر رو مي بينيد :
کد:var listener:Object=new Object();
FileRef.addListener(listener)
حالا شما به رويداد هاي زير دسترسي داريد :
listener.onSelect : زماني که کاربر فايلي رو انتخاب کرد اين رويداد فعال ميشه براي استفاده از اون ميتونيد به شکل زير استفاده کنيد .
زماني که اين ويداد فعال ميشود يک شي به تابع فرستاده ميشه که شما ميتونيد اطلاعاتي از قبيل نام و نوع و حجم فايل رو با اين شي بدست بياريد.کد:listener.onSelect=function(file:FileReference){
trace(file.type)
trace(file.name)
trace(file.size)
}
listener.onCancel : اين رويداد زماني فعال ميشود که کاربر انتخاب فايل را Cancel نمايد.
listener.onComplete : اين رويداد زماني فعال ميشود که عمل upload يا download با موفقيت به پايان برسه.کد:
listener.onCancel=function(file:FileReference){
trace("cancel")
}
اما رويداد هاي ديگري هم هستند که من بعد ها سعي ميکنم اونها رو هم توضيح بدم ولي فعلا تا اينحا کافيه.
حالا ميرسيم به دو متد مهم از اين کلاس ، upload و ديگري download :
Upload :
از اين متد مي تونيد براي آپلود کردن فايل انتخابي کاربر بر روي سرور استفاده کنيد اين تابع يک رشته کاراکتري رو به عنوان آرگومان دريافت ميکنه اين رشته آدرس اسکريپتي است که فايل
رو آپلود ميکنه مثلا [ برای مشاهده لینک ، با نام کاربری خود وارد شوید یا ثبت نام کنید ]
و حتي ميتونيد اطلاعات ديگه اي رو با روش GET به انتهاي آدرس اضافه و ارسال کنيد.
توجه داشته باشيد که بعضي از مرورگر ها url هاي بيشتر از 256 کاراکتر رو پشتيباني نميکنند.
نحوه استفاده :
Download : متد بعدي اين کلاس Download است که کاربر ميتونه فايلي رو در سيستم خودش ذخيره کنه.کد:listener.onSelect = function(file:FileReference):Void {
trace("onSelect: " + file.name);
if(!file.upload("http://www.yourdomain.com/yourUploadHandlerScript.cfm")) {
trace("Upload dialog failed to open.");
}
براي استفاده از اين متد ابتدا يک شي FileReference ميسازيد و سپس يک شنودگر براي کنترل روندکار سپس تابع دانلود رو فراخواني ميکنيد اين تابع يک آرکومان ورودي مي پذيره که
آدرس فايلي است که کاربر قصد دانلود اون رو داره.
بعد از فراخواني اين تابع پنجره اي براي کاربر باز ميشه تا مسير ذخيره فايل رو انتخاب کنه و سپس عمل دانلود آغاز ميشه.
اين هم يک مثال :
کد:var fileRef:FileReference = new FileReference();
fileRef.addListener(listener);
var url:String = "http://mywebsite/FileRe.pdf";
if(!fileRef.download(url, "FlashPlatform.pdf")) {
trace("dialog box failed to open.");
}
