FileReference

套件	flash.net
類別	public class FileReference
繼承	FileReference EventDispatcher Object
子類別	File

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

FileReference 類別提供一個可以在使用者電腦與伺服器之間上傳和下載檔案的工具。作業系統對話方塊會提示使用者選取要上傳的檔案或下載的位置。每一個 FileReference 物件都會參照使用者磁碟上的單一檔案，並且具有包含有關檔案大小、類型、名稱、建立日期、修改日期和建立者類型 (僅適用於 Macintosh) 等資訊的屬性。

注意：在 Adobe AIR中，File 類別會擴充 FileReference 類別，提供比 FileReference 類別更多的能力且較少的安全性限制。

建立 FileReference 實體的方法有兩種：

當您使用 new 運算子並搭配 FileReference 建構函式時： var myFileReference = new FileReference();
當您呼叫 FileReferenceList.browse() 方法時，該方法就會建立 FileReference 物件的陣列。

上傳作業期間，FileReference 物件的所有屬性是藉由呼叫 FileReference.browse() 或 FileReferenceList.browse() 方法來填入。下載作業期間，name 屬性會在傳送 select 事件時填入，而所有其它屬性則是在傳送 complete 事件時填入。

browse() 方法會開啟作業系統對話方塊，提示使用者選取上傳檔案。 FileReference.browse() 方法會讓使用者選取單一檔案；FileReferenceList.browse() 方法則讓使用者選取多個檔案。成功呼叫 browse() 方法之後，請呼叫 FileReference.upload() 方法逐一上傳檔案。 FileReference.download() 方法會提示使用者提供儲存檔案的位置，並從遠端 URL 起始下載。

FileReference 和 FileReferenceList 類別不會讓您針對 browse() 和 download() 所產生的對話方塊設定預設檔案位置。對話方塊內顯示的預設位置是最近瀏覽過的資料夾 (如果該位置是可以判斷的) 或桌面。這些類別不允許您讀取或寫入已傳輸的檔案，也不允許起始上傳或下載的 SWF 檔來存取上傳或下載的檔案，或使用者磁碟上的檔案位置。

FileReference 和 FileReferenceList 類別並不提供驗證的方法。對於需要驗證的伺服器，您可以使用 Flash ^® Player 瀏覽器外掛程式來下載檔案，但是上傳 (在任何播放程式上進行) 和下載 (在獨立的或外部的播放程式上進行) 則會失敗。請偵聽 FileReference 事件，判斷作業是否順利完成，並處理錯誤。

針對 Flash Player 中的執行內容或在 Adobe AIR 中但在應用程式安全執行程序外的執行內容，上傳和下載作業只能存取其專屬網域內和 URL 原則檔指定的任何網域內的檔案。如果起始上傳或下載的內容與檔案伺服器並非來自相同的網域，請在檔案伺服器上放置原則檔。

請注意，因為 Flash Player 中加入新功能的緣故，當您發佈到 Flash Player 10 時，下列作業在同一時間內只能有一個為作用中：FileReference.browse()、FileReference.upload()、FileReference.download()、FileReference.load()、FileReference.save()。否則，Flash Player 會擲出執行階段錯誤 (代碼 2174)。使用 FileReference.cancel() 停止進行中的作業。這項限制僅適用於 Flash Player 10。舊版 Flash Player 不受這個多項作業同時進行限制的影響。

執行 FileReference.browse()、FileReferenceList.browse() 或 FileReference.download() 方法呼叫時，在 Linux 與 Mac OS X 10.1 和更早版本的獨立與外部版本 Flash Player 以及 AIR 中，會暫停播放 SWF 檔。

如果沒有指定任何參數，下列樣本 HTTP POST 要求就會從 Flash Player 傳送至伺服器端程式碼：

  POST /handler.cfm HTTP/1.1 
  Accept: text/*
  Content-Type: multipart/form-data; 
  boundary=----------Ij5ae0ae0KM7GI3KM7 
  User-Agent: Shockwave Flash 
  Host: www.example.com 
  Content-Length: 421 
  Connection: Keep-Alive 
  Cache-Control: no-cache
  
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Filename"
  
  MyFile.jpg
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Filedata"; filename="MyFile.jpg"
  Content-Type: application/octet-stream
  
  FileDataHere
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Upload"
  
  Submit Query
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7--

如果使用者指定 "api_sig"、"api_key" 和 "auth_token" 參數，Flash Player 就會傳送下列 HTTP POST 要求：

  POST /handler.cfm HTTP/1.1 
  Accept: text/*
  Content-Type: multipart/form-data; 
  boundary=----------Ij5ae0ae0KM7GI3KM7 
  User-Agent: Shockwave Flash 
  Host: www.example.com 
  Content-Length: 421 
  Connection: Keep-Alive 
  Cache-Control: no-cache
  
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Filename"
  
  MyFile.jpg
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="api_sig"
  
  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="api_key"
  
  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="auth_token"
  
  XXXXXXXXXXXXXXXXXXXXXX
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Filedata"; filename="MyFile.jpg"
  Content-Type: application/octet-stream
  
  FileDataHere
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7
  Content-Disposition: form-data; name="Upload"
  
  Submit Query
  ------------Ij5GI3GI3ei4GI3ei4KM7GI3KM7KM7--

檢視範例

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		creationDate : Date [唯讀] 本機磁碟上的檔案建立日期。	FileReference
		creator : String [唯讀] 檔案的 Macintosh 建立者類型，只能在 Mac OS X 之前的 Mac OS 版本中使用。	FileReference
		data : ByteArray [唯讀] ByteArray 物件，代表成功呼叫 load() 方法後載入的檔案所包含的資料。	FileReference
		extension : String [唯讀] 副檔名。	FileReference
		modificationDate : Date [唯讀] 本機磁碟上最後修改檔案的日期。	FileReference
		name : String [唯讀] 本機磁碟上的檔案名稱。	FileReference
		permissionStatus : String [靜態] [唯讀] 判斷應用程式是否已獲得存取檔案系統的權限。	FileReference
		size : Number [唯讀] 本機磁碟上的檔案大小，以位元組為單位。	FileReference
		type : String [唯讀] 檔案類型。	FileReference

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		FileReference() 建立新的 FileReference 物件。	FileReference
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		browse(typeFilter:Array = null):Boolean 顯示檔案瀏覽對話方塊，讓使用者選取要上傳的檔案。	FileReference
		cancel():void 取消此 FileReference 物件上的任何上傳或下載作業。	FileReference
		dispatchEvent(event:Event):Boolean 會將事件傳送到事件流程。	EventDispatcher
		download(request:URLRequest, defaultFileName:String = null):void 會開啟對話方塊，讓使用者能從遠端伺服器下載檔案。	FileReference
		hasEventListener(type:String):Boolean 會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		load():void 開始載入使用者所選取的本機檔案。	FileReference
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 會從 EventDispatcher 物件移除偵聽程式。	EventDispatcher
		requestPermission():void 要求權限以存取檔案系統。	FileReference
		save(data:*, defaultFileName:String = null):void 開啟對話方塊，讓使用者能夠將檔案儲存至本機檔案系統。	FileReference
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		upload(request:URLRequest, uploadDataFieldName:String = "Filedata", testUpload:Boolean = false):void 開始將檔案上傳到遠端伺服器。	FileReference
		uploadUnencoded(request:URLRequest):void 不使用任何編碼，起始上傳檔案至 URL。	FileReference
		valueOf():Object 會傳回指定之物件的基本值。	Object
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	EventDispatcher

事件

按一下以瞭解事件的詳細資訊

隱藏繼承事件

顯示繼承事件

	摘要	定義自
activate	[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。	EventDispatcher
cancel	在使用者透過檔案瀏覽對話方塊取消檔案上傳或載入作業時傳送。	FileReference
complete	在下載完成或上傳產生 HTTP 狀態碼 200 時傳送。	FileReference
deactivate	[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。	EventDispatcher
httpResponseStatus	當 upload() 或 uploadUnencoded() 方法呼叫嘗試透過 HTTP 存取資料，而且 Adobe AIR 能夠偵測並傳回要求的狀態碼時傳送。	FileReference
httpStatus	在上傳失敗時傳送，而且 HTTP 狀態碼可用於描述失敗。	FileReference
ioError	在上傳或下載失敗時傳送。	FileReference
open	在上傳或下載作業開始時傳送。	FileReference
permissionStatus	當應用程式要求權限以存取檔案系統時傳送。	FileReference
progress	在檔案上傳或下載作業期間定期傳送。	FileReference
securityError	在 FileReference.upload() 或 FileReference.download() 方法的呼叫嘗試將檔案上傳至伺服器，或從呼叫者安全執行程序以外的伺服器取得檔案時傳送。	FileReference
select	在使用者從檔案瀏覽對話方塊中，選取要上傳或下載的檔案時傳送。	FileReference
uploadCompleteData	在成功上傳後，從伺服器接到資料以後傳送。	FileReference

屬性詳細資訊

creationDate

屬性

creationDate:Date [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

本機磁碟上的檔案建立日期。如果尚未填入物件，取得這個屬性值的呼叫會傳回 null。

注意：如果作業系統沒有 creationDate 做為其屬性，在這種情況下，CreationDate 等於 lastModifiedDate。

實作
public function get creationDate():Date

擲回值

	`IllegalOperationError` — 如果呼叫 `FileReference.browse()`、`FileReferenceList.browse()` 或 `FileReference.download()` 方法不成功，就會擲回例外，並出現訊息，指出呼叫函數的順序錯誤或之前的呼叫不成功。在此情況下，`creationDate` 屬性的值會是 `null`。

	`IOError` — 如果無法存取檔案資訊，就會擲回例外，並出現指出檔案 I/O 錯誤的訊息。

相關 API 元素

FileReference.browse()

creator

屬性

creator:String [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

檔案的 Macintosh 建立者類型，僅用於 Mac OS X 之前的 Mac OS 版本。在 Windows 或 Linux 中，這個屬性是 null。如果尚未填入 FileReference 物件，取得這個屬性值的呼叫會傳回 null。

實作
public function get creator():String

擲回值

IllegalOperationError — 在 Macintosh 上，如果呼叫 FileReference.browse()、FileReferenceList.browse() 或 FileReference.download() 方法不成功，就會擲回例外，並出現訊息，指出呼叫函數的順序錯誤或之前的呼叫不成功。在此情況下，creator 屬性的值會是 null。

data

屬性

data:ByteArray [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5

ByteArray 物件，代表成功呼叫 load() 方法後載入的檔案所包含的資料。

實作
public function get data():ByteArray

擲回值

	`IllegalOperationError` — 如果呼叫 `load()` 方法不成功，就會擲出例外並出現訊息，指出函數呼叫順序錯誤或之前的呼叫不成功。在此情況下，`data` 屬性的值會是 `null`。

	`IOError` — 如果無法開啟或讀取檔案，或者存取檔案時遇到類似的錯誤，就會擲回例外，並出現指出檔案 I/O 錯誤的訊息。在此情況下，`data` 屬性的值會是 `null`。

extension

屬性

extension:String [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

副檔名。

副檔名是最後一點 (".") 後面 (不含 "." 本身) 的名稱部分。如果檔案名稱中沒有點，則副檔名為 null。

注意：您應該使用 extension 屬性決定檔案類型，不要使用 creator 或 type 屬性。不建議使用 creator 和 type 屬性，它們僅適用於舊版的 Mac OS。

實作
public function get extension():String

擲回值

IllegalOperationError — 如果參考未初始化。

modificationDate

屬性

modificationDate:Date [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Player 9

本機磁碟上最後修改檔案的日期。如果尚未填入 FileReference 物件，取得這個屬性值的呼叫會傳回 null。

實作
public function get modificationDate():Date

擲回值

	`IllegalOperationError` — 如果呼叫 `FileReference.browse()`、`FileReferenceList.browse()` 或 `FileReference.download()` 方法不成功，就會擲回例外，並出現訊息，指出呼叫函數的順序錯誤或之前的呼叫不成功。在此情況下，`modificationDate` 屬性的值會是 `null`。

	`IOError` — 如果無法存取檔案資訊，就會擲回例外，並出現指出檔案 I/O 錯誤的訊息。

相關 API 元素

FileReference.browse()

name

屬性

name:String [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

本機磁碟上的檔案名稱。如果未填入 FileReference 物件 (藉由有效呼叫 FileReference.download() 或 FileReference.browse())，當您嘗試取得這個屬性值時，Flash Player 會擲出錯誤。

FileReference 物件的所有屬性，都是藉由呼叫 browse() 方法所填入。與其它 FileReference 屬性不同的是，如果您呼叫 download() 方法，則 name 屬性會在傳送 select 事件時填入。

實作
public function get name():String

擲回值

IllegalOperationError — 如果呼叫 FileReference.browse()、FileReferenceList.browse() 或 FileReference.download() 方法不成功，就會擲回例外，並出現訊息，指出呼叫函數的順序錯誤或之前的呼叫不成功。

相關 API 元素

FileReference.browse()

permissionStatus

屬性

permissionStatus:String [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 24.0

判斷應用程式是否已獲得存取檔案系統的權限。

實作
public static function get permissionStatus():String

相關 API 元素

flash.permissions.PermissionStatus

size

屬性

size:Number [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

本機磁碟上的檔案大小，以位元組為單位。

注意：在初始版本的 ActionScript 3.0 中，size 屬性是定義為 uint 物件，支援多達約 4 GB 大小的檔案。現已將它實作為 Number 物件，以支援較大的檔案。

實作
public function get size():Number

擲回值

	`IllegalOperationError` — 如果呼叫 `FileReference.browse()`、`FileReferenceList.browse()` 或 `FileReference.download()` 方法不成功，就會擲回例外，並出現訊息，指出呼叫函數的順序錯誤或之前的呼叫不成功。

	`IOError` — 如果無法開啟或讀取檔案，或者存取檔案時遇到類似的錯誤，就會擲回例外，並出現指出檔案 I/O 錯誤的訊息。

相關 API 元素

FileReference.browse()

type

屬性

type:String [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

檔案類型。

在 Windows 或 Linux 中，這個屬性是副檔名。在 Macintosh 上，這個屬性是四個字元的檔案類型，只能在 Mac OS X 之前的 Mac OS 版本中使用。如果未填入 FileReference 物件，取得這個屬性值的呼叫會傳回 null。

對於 Windows、Linux 和 Mac OS X，副檔名 (即 name 屬性中在最後一個點 (.) 字元後面的部分) 會識別檔案類型。

實作
public function get type():String

擲回值

IllegalOperationError — 如果呼叫 FileReference.browse()、FileReferenceList.browse() 或 FileReference.download() 方法不成功，就會擲回例外，並出現訊息，指出呼叫函數的順序錯誤或之前的呼叫不成功。在此情況下，type 屬性的值會是 null。

相關 API 元素

FileReference.extension

建構函式詳細資料

()

建構函式

public function FileReference()

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

建立新的 FileReference 物件。進行填入時，FileReference 物件代表使用者本機磁碟上的檔案。

相關 API 元素

FileReference.browse()

方法詳細資訊

browse

()

方法

public function browse(typeFilter:Array = null):Boolean

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

顯示檔案瀏覽對話方塊，讓使用者選取要上傳的檔案。這個對話方塊是使用者作業系統本身所提供的。例如，使用者可以透過 Windows 的 UNC 路徑，選取本機電腦或其它系統上的檔案。

注意：Adobe AIR 提供的 File 類別包含存取更多特定系統檔案選取的對話方塊。這些方法是 File.browseForDirectory()、File.browseForOpen()、File.browseForOpenMultiple() 以及 File.browseForSave()。

當您呼叫此方法而使用者成功選取檔案時，此 FileReference 物件的屬性便會由該檔案的屬性所填入。此後每次呼叫 FileReference.browse() 方法時，FileReference 物件的屬性都會重設為使用者在對話方塊中選取的檔案。一次只能執行一個 browse() 或 download() 工作階段 (因為一次只能叫用一個對話方塊)。

您可以使用 typeFilter 參數，決定對話方塊所顯示的檔案。

在 Flash Player 10 和 Flash Player 9 更新 5 版本中，只有在回應使用者事件 (例如，在按下滑鼠或按下按鍵事件的事件處理常式中) 時，才能成功呼叫這個方法。否則，呼叫這個方法會導致 Flash Player 擲出錯誤例外。

在 Adobe AIR 中，檔案瀏覽對話方塊不一定會顯示在由其他視窗所「擁有」的視窗前面 (owner 屬性不是 Null 的視窗)。若要避免發生視窗排序問題，請在呼叫此方法之前隱藏擁有的視窗。

參數

typeFilter:Array (default = null) — FileFilter 實體的陣列，用來篩選顯示於對話方塊內的檔案。如果省略此參數，便會顯示全部檔案。如需詳細資訊，請參閱 FileFilter 類別。

傳回值

Boolean — 如果參數有效且檔案瀏覽對話方塊已開啟，便會傳回 true。

事件

	`select:Event` — 在使用者成功從「瀏覽」檔案視窗中選取項目時傳送。

	`cancel:Event` — 在使用者取消檔案上傳「瀏覽」視窗時傳送。

擲回值

	`IllegalOperationError` — 會在下列情況下擲回：1) 另一個 FileReference 或 FileReferenceList 瀏覽工作階段正在處理中。一次只能執行一個檔案瀏覽工作階段。 2) 使用者之 mms.cfg 檔案中的設定禁止了這項作業。

	`ArgumentError` — 如果 `typeFilter` 陣列包含格式不正確的 FileFilter 物件，就會擲回例外。如需 FileFilter 物件之正確格式的詳細資訊，請參閱 FileFilter 類別。

	`Error` — 如果不是為了回應使用者的動作 (例如滑鼠事件或按下按鍵事件) 而呼叫方法。

相關 API 元素

select event
cancel event
FileReference.download()
FileReferenceList.browse()
File.browseForDirectory()
File.browseForOpen()
File.browseForOpenMultiple()
File.browseForSave()

cancel

()

方法

public function cancel():void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

取消此 FileReference 物件上的任何上傳或下載作業。呼叫這個方法並不會傳送 cancel 事件。該事件只有在使用者透過關閉檔案上傳或下載對話方塊來取消作業時才會傳送。

download

()

方法

public function download(request:URLRequest, defaultFileName:String = null):void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

會開啟對話方塊，讓使用者能從遠端伺服器下載檔案。雖然 Flash Player 對您可上傳或下載的檔案大小沒有設定任何限制，不過此播放程式最多只支援 100 MB 的上傳或下載。

download() 方法會先開啟作業系統對話方塊，要求使用者輸入檔案名稱，並選取要在本機電腦上儲存檔案的位置。當使用者選取了一個位置並確認下載作業 (例如，按一下「儲存」)，便會從遠端伺服器開始下載。偵聽程式會接收事件以指出下載的進度、成功或失敗。若要在呼叫 download() 之後查明對話方塊和下載作業的狀態，程式碼就必須偵聽 cancel、open、progress 和 complete 等事件。

FileReference.upload() 和 FileReference.download() 都是非阻隔式函數。這些函數會在呼叫之後、檔案傳輸完成之前傳回。此外，如果 FileReference 物件超出範圍，就會在離開範圍時，取消該物件尚未完成的任何上傳或下載。只要想讓上傳或下載繼續進行，就必須確定 FileReference 物件保持在範圍內。

當檔案下載成功時，本機檔案的屬性就會填入 FileReference 物件的屬性。如果下載成功，就會傳送 complete 事件。

一次只能執行一個 browse() 或 download() 工作階段 (因為一次只能叫用一個對話方塊)。

此方法以 HTTP 或 HTTPS 支援下載任何檔案類型。

您不可以連接到常用的保留連接埠。完整的封鎖連接埠清單，請參閱在「ActionScript 3.0 開發人員指南」中的「限制網路 API」。

注意：如果伺服器需要使用者驗證，則只有在瀏覽器中執行 (也就是使用瀏覽器外掛程式或 ActiveX 控制項) 的 SWF 檔才能提供對話方塊，以提示使用者輸入可供驗證且僅供下載之用的使用者名稱和密碼。如果使用外掛程式或 ActiveX 控制項上傳，或是使用獨立或外部播放程式進行上傳及下載，則檔案傳輸會失敗。

使用此方法時，必須顧及 Flash Player 安全性模型：

如果呼叫的 SWF 檔位於不受信任的本機安全執行程序中，則不允許載入作業。
預設行為是拒絕安全執行程序之間的存取。但是網站可以新增 URL 原則檔，啟用對資源的存取。
您可以拒絕 SWF 檔使用這個方法，方式是在包含 SWF 內容的 HTML 網頁中，設定 object 和 embed 標籤的 allowNetworking 參數。
在 Flash Player 10 和 Flash Player 9 更新 5 版本中，只有在回應使用者事件 (例如，在按下滑鼠或按下按鍵事件的事件處理常式中) 時，才能成功呼叫這個方法。否則，呼叫這個方法會導致 Flash Player 擲出錯誤例外。

但在 Adobe AIR 中，application 安全執行程序中的內容 (使用 AIR 應用程式所安裝的內容) 沒有這些安全性限制。

如需安全性詳細資訊，請參閱「Flash Player 開發人員中心」主題：安全性。

當您使用這個方法下載檔案時，在可標示已下載檔案的作業系統上，會標示為已下載：

Windows XP Service Pack 2 和更新版本，以及在 Windows Vista 上
Mac OS 10.5 與更新的版本

一些作業系統，例如 Linux，無法標示下載的檔案。

在 Adobe AIR 中，下載對話方塊不一定會顯示在由其他視窗所「擁有」的視窗前面 (owner 屬性不是 Null 的視窗)。若要避免發生視窗排序問題，請在呼叫此方法之前隱藏擁有的視窗。

參數

	`request:URLRequest` — URLRequest 物件。 URLRequest 物件的 `url` 屬性應該包含要下載至本機電腦之檔案的 URL。如果此參數為 `null`，就會擲回例外。 URLRequest 物件的 `requestHeaders` 屬性會被忽略；上傳或下載不支援自訂 HTTP 要求檔頭。若要將 `POST` 或 GET 參數傳送至伺服器，請將 `URLRequest.data` 的值設定為您的參數，並將 `URLRequest.method` 設定為 `URLRequestMethod.POST` 或 `URLRequestMethod.GET`。在某些瀏覽器上，URL 字串有長度上的限制。長度超過 256 個字元，就可能在某些瀏覽器或伺服器上造成失敗。

	`defaultFileName:String` (default = `null`) — 顯示在對話方塊內的預設檔案名稱，代表要下載的檔案。這個字串不能包含下列字元： / \ : * ? " < > \| % 如果您省略這個參數，就會剖析遠端 URL 的檔案名稱並做為預設值。

事件

	`open:Event` — 在下載作業開始時傳送。

	`progress:ProgressEvent` — 在檔案下載作業期間定期傳送。

	`complete:Event` — 在檔案下載作業順利完成時傳送。

	`cancel:Event` — 在使用者關閉對話方塊時傳送。

	`select:Event` — 在使用者從對話方塊中選取要下載的檔案時傳送。

	`securityError:SecurityErrorEvent` — 在下載因安全性錯誤而失敗時傳送。

	`ioError:IOErrorEvent` — 因下列任一原因傳送：當檔案正在讀取或傳送時，發生輸入/輸出錯誤。在獨立或外部版本的 Flash Player 中執行的 SWF 內容嘗試從需要驗證的伺服器下載檔案。由於在下載期間，獨立和外部播放程式沒有提供讓使用者輸入密碼的方式。如果這些播放程式內的 SWF 嘗試自需要驗證的伺服器下載檔案，則下載會失敗。只有在 ActiveX 控制項和瀏覽器外掛播放程式內才有可能成功下載檔案。

擲回值

	`IllegalOperationError` — 會在下列情況下擲回：1) 另一個瀏覽工作階段正在處理中。一次只能執行一個檔案瀏覽工作階段。2) 傳遞給 `request` 的值並不包含有效的路徑或通訊協定。 3) 要下載的檔案名稱包含禁止的字元。 4) 使用者之 mms.cfg 檔案中的設定禁止了這項作業。

	`SecurityError` — 本機不受信任的內容可能無法與網際網路進行通訊。若要避免這種情況，請將此 SWF 檔重新分類為「具有網路連線的本機」或受信任。擲回例外時會出現訊息，指出基於本機檔案安全性限制而無法存取的檔案名稱和 URL。

	`SecurityError` — 您不可以連接到常用的保留連接埠。完整的封鎖連接埠清單，請參閱在「ActionScript 3.0 開發人員指南」中的「限制網路 API」。

	`ArgumentError` — 如果 `url.data` 的類型為 ByteArray，就會擲回例外。若要搭配 `FileReference.upload()` 和 `FileReference.download()` 方法使用，`url.data` 的類型只能是 URLVariables 或 String。

	`MemoryError` — 這項錯誤可能會因為下列原因而發生：1) Flash Player 無法將 `URLRequest.data` 參數從 UTF8 轉換成 MBCS。如果傳遞給 `FileReference.download()` 方法的 URLRequest 物件設定為執行 GET 作業，而且 `System.useCodePage` 設定為 `true`，就會發生這項錯誤。 2) Flash Player 無法分配 `POST` 資料的記憶體。如果傳遞給 `FileReference.download()` 方法的 URLRequest 物件設定為執行 `POST` 作業，就會發生這項錯誤。

	`Error` — 如果不是為了回應使用者的動作 (例如滑鼠事件或按下按鍵事件) 而呼叫方法。

範例 ( 如何使用本範例 )

下列範例會說明 download 事件物件的使用方式。如果要執行這個範例，請變更 downloadURL.url 屬性，將它指向實際的網域和檔案，而不是虛構的 http://www.[yourDomain].com/SomeFile.pdf。您可能還需要編譯 SWF 檔，並將「本機播放安全性」設定為「只存取網路」，或更新 Flash Player 安全性設定，以便允許此檔案進行網路存取。

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;
    import flash.net.FileFilter;

    public class FileReference_download extends Sprite {
        private var downloadURL:URLRequest;
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function FileReference_download() {
            downloadURL = new URLRequest();
            downloadURL.url = "http://www.[yourDomain].com/SomeFile.pdf";
            file = new FileReference();
            configureListeners(file);
            file.download(downloadURL, fileName);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.CANCEL, cancelHandler);
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(Event.SELECT, selectHandler);
        }

        private function cancelHandler(event:Event):void {
            trace("cancelHandler: " + event);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + downloadURL.url);
        }
    }
}

load

()

方法

public function load():void

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5

開始載入使用者所選取的本機檔案。雖然 Flash Player 對您可上傳、下載、載入或儲存的檔案大小沒有設定任何限制，此播放程式最多只支援 100 MB 的檔案。若為 Flash Player 中執行的內容，您必須先呼叫 FileReference.browse() 或 FileReferenceList.browse() 方法，然後再呼叫 load() 方法。不過，在 AIR 應用程式安全執行程序中執行的內容不需要先呼叫 browse() 方法，就可以呼叫 File 物件的 load() 方法 (AIR 的 File 類別乃是擴充 FileReference 類別)。

偵聽程式會接收事件，以指出載入的進度、成功或失敗。雖然可以使用 FileReferenceList 物件，讓使用者選取多個載入的檔案，但您還是必須一次只載入一個檔案。若要逐一載入每個檔案，請重複執行 FileReference 物件的 FileReferenceList.fileList 陣列。

Adobe AIR 也包含提供更多讀取檔案選項的 FileStream 類別。

FileReference.upload()、FileReference.download()、FileReference.load() 和 FileReference.save() 函數都是非阻隔式函數。這些函數會在呼叫之後、檔案傳輸完成之前傳回。此外，如果 FileReference 物件超出範圍，就會在離開範圍時，取消該物件尚未完成的任何交易。如果希望上傳、下載、載入或儲存繼續進行，就必須確定 FileReference 物件保持在範圍內。

如果檔案順利載入完成，其內容會以位元組陣列形式儲存至 FileReference 物件的 data 屬性。

切記下列安全性考量：

如果呼叫的 SWF 檔位於不受信任的本機安全執行程序中，則不允許載入作業。
預設行為是拒絕安全執行程序之間的存取。網站可以新增跨網域原則檔來啟用對資源的存取。
如果您希望防止任何檔案使用此方法，可以在包含 SWF 內容的 HTML 頁面中，設定 object 和 embed 標籤的 allowNetworking 參數。

不過，這些考量事項對於應用程式安全執行程序中的 AIR 內容並不適用。

請注意，當您發佈到 Flash Player 10 或 AIR 1.5 時，下列作業在同一時間內只能有一個為作用中：FileReference.browse()、FileReference.upload()、FileReference.download()、FileReference.load()、FileReference.save()。否則，應用程式會擲出執行階段錯誤 (代碼 2174)。使用 FileReference.cancel() 停止進行中的作業。這項限制僅適用於 Flash Player 10 和 AIR 1.5。舊版 Flash Player 或 AIR 不受這類多項作業同時進行限制的影響。

事件

	`open:Event` — 在載入作業開始時傳送。

	`progress:ProgressEvent` — 在檔案載入作業期間定期傳送。

	`complete:Event` — 在檔案載入作業順利完成時傳送。

	`ioError:IOErrorEvent` — 在應用程式讀取或寫入檔案時發生輸入/輸出錯誤而導致載入失敗時叫用。

擲回值

	`IllegalOperationError` — 會在下列情況下擲回：1) 另一個 FileReference 或 FileReferenceList 瀏覽工作階段正在處理中。一次只能執行一個檔案瀏覽工作階段。 2) 使用者之 mms.cfg 檔案中的設定禁止了這項作業。

	`MemoryError` — 如果應用程式無法針對檔案配置記憶體，就可能會發生這項錯誤。檔案可能太大，或者可用的記憶體太少。

範例 ( 如何使用本範例 )

以下範例會從您的本機檔案系統將影像上載至根顯示物件 (此處指的是舞臺)。範例由 Andre Venancio 所提供。

var buttonShape:Shape = new Shape();
buttonShape.graphics.beginFill(0x336699);
buttonShape.graphics.drawCircle(50, 50, 25);
var button = new SimpleButton(buttonShape, buttonShape, buttonShape, buttonShape);
addChild(button);

var fileRef:FileReference= new FileReference();
button.addEventListener(MouseEvent.CLICK, onButtonClick);

function onButtonClick(e:MouseEvent):void {
fileRef.browse([new FileFilter("Images", "*.jpg;*.gif;*.png")]);
fileRef.addEventListener(Event.SELECT, onFileSelected);
}

function onFileSelected(e:Event):void {
fileRef.addEventListener(Event.COMPLETE, onFileLoaded);
fileRef.load();
}

function onFileLoaded(e:Event):void {
var loader:Loader = new Loader();
loader.loadBytes(e.target.data);
addChild(loader);
}

requestPermission

()

方法

public function requestPermission():void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 24.0

要求權限以存取檔案系統。

事件

PermissionStatus:PermissionEvent — 由使用者授與/拒絕要求的權限時傳送。

save

()

方法

public function save(data:*, defaultFileName:String = null):void

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10, AIR 1.5

開啟對話方塊，讓使用者能夠將檔案儲存至本機檔案系統。雖然 Flash Player 對您可上傳、下載、載入或儲存的檔案大小沒有設定任何限制，此播放程式最多只支援 100 MB 的檔案。

save() 方法會先開啟作業系統對話方塊，要求使用者輸入檔案名稱，並選取要在本機電腦上儲存檔案的位置。當使用者選取了一個位置並確認儲存作業 (例如，按一下「儲存」)，便會開始進行儲存程序。偵聽程式會接收事件以指出儲存作業的進度、成功或失敗。若要在呼叫 save() 之後查明對話方塊和儲存作業的狀態，程式碼就必須偵聽 cancel、open、progress 和 complete 等事件。

Adobe AIR 也包含提供更多本機儲存檔案選項的 FileStream 類別。

當檔案儲存成功時，本機檔案的屬性就會填入 FileReference 物件的屬性。如果儲存成功，就會傳送 complete 事件。

一次只能執行一個 browse() 或 save() 工作階段 (因為一次只能叫用一個對話方塊)。

在 Flash Player 中，只有在回應使用者事件 (例如，在按下滑鼠或按下按鍵事件的事件處理常式中) 時，才能成功呼叫這個方法。否則，呼叫這個方法會導致 Flash Player 擲出錯誤例外。應用程式安全執行程序中的 AIR 內容不受此限制。

在 Adobe AIR 中，儲存對話方塊不一定會顯示在由其他視窗所「擁有」的視窗前面 (owner 屬性不是 Null 的視窗)。若要避免發生視窗排序問題，請在呼叫此方法之前隱藏擁有的視窗。

參數

	`data:*` — 要儲存的資料。此資料可以採用下列其中一種格式，而且將以適當的方式處理：如果其值為 `null`，應用程式會擲出 ArgumentError 例外。如果其值為 String，就會儲存成 UTF-8 文字檔。如果其值為 XML，就會以 XML 格式寫入文字檔，並保留所有格式設定。如果其值為 ByteArray 物件，就會逐字寫入資料檔案。如果其值為以上皆非，`save()` 方法就會呼叫此物件的 `toString()` 方法先將資料轉換成字串，再將資料儲存成文字檔。若這項作業失敗，應用程式即擲出 ArgumentError 例外。

	`defaultFileName:String` (default = `null`) — 顯示在對話方塊內的預設檔案名稱，代表要儲存的檔案。這個字串不能包含下列字元： / \ : * ? " < > \| % 一旦 File 物件呼叫此方法，檔案名稱即為 File 物件所參照的檔案之檔名 (AIR 的 File 類別乃是擴充 FileReference 類別)。

事件

	`open:Event` — 在下載作業開始時傳送。

	`progress:ProgressEvent` — 在檔案下載作業期間定期傳送。

	`complete:Event` — 在檔案下載作業順利完成時傳送。

	`cancel:Event` — 在使用者關閉對話方塊時傳送。

	`select:Event` — 在使用者從對話方塊中選取要下載的檔案時傳送。

	`ioError:IOErrorEvent` — 如果讀取或傳輸檔案時發生輸入/輸出錯誤便傳送。

擲回值

	`IllegalOperationError` — 會在下列情況下擲回：1) 另一個瀏覽工作階段正在處理中。一次只能執行一個檔案瀏覽工作階段。2) 要下載的檔案名稱包含禁止的字元。3) 使用者之 mms.cfg 檔案中的設定禁止了這項作業。

	`ArgumentError` — 如果 `data` 的類型不是 ByteArray，而且它沒有 `toString()` 方法，就會擲回例外。如果 `data` 的類型不是 XML，而且它沒有 `toXMLString()` 方法，就會擲回例外。

	`Error` — 如果不是為了回應使用者的動作 (例如滑鼠事件或按下按鍵事件) 而呼叫方法。

	`MemoryError` — 如果 Flash Player 無法針對檔案配置記憶體，就可能會發生這項錯誤。檔案可能太大，或者可用的記憶體太少。

範例 ( 如何使用本範例 )

下列範例將文字欄位中輸入的內容儲存到檔案。該範例建立可編輯的文字欄位 (MyTextField) 及另一個不可編輯的文字欄位 (MyButtonField) 當做是「按鈕」以回應按一下滑鼠動作。使用者可以編輯第一個文字欄位並按下按鈕，以儲存文字欄位內容到本機檔案。滑鼠按鍵事件處理常式 clickhandler 使用 FileReference.save() 方法 (對名為 MyFileReference 的 FileReference 物件) 開啟在使用者目前作業系統上的對話方塊，讓使用者可以利用使用者提供的名稱儲存內容到本機檔案。

var MyTextField:TextField = new TextField();
var MyButtonField:TextField = new TextField();
var MyFile:FileReference = new FileReference();

MyTextField.border = true;
MyTextField.type = TextFieldType.INPUT;

MyButtonField.background = true;
MyButtonField.backgroundColor = 0x339933;
MyButtonField.x = 150;
MyButtonField.height = 20;
MyButtonField.text = "Click here to save";

addChild(MyTextField);
addChild(MyButtonField);
MyButtonField.addEventListener(MouseEvent.CLICK, clickhandler);

function clickhandler(e:MouseEvent): void {
    MyFile.save(MyTextField.text);
}

upload

()

方法

public function upload(request:URLRequest, uploadDataFieldName:String = "Filedata", testUpload:Boolean = false):void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

開始將檔案上傳到遠端伺服器。雖然 Flash Player 對您可上傳或下載的檔案大小沒有設定任何限制，不過此播放程式最多只支援 100 MB 的上傳或下載。您必須先呼叫 FileReference.browse() 或 FileReferenceList.browse() 方法，然後再呼叫此方法。

針對 Adobe AIR 檔案類別 (擴充 FileReference 類別)，您可以使用 upload() 方法以上載任何檔案。對於 FileReference 類別 (在 Flash Player 中使用)，使用者必須先選擇檔案。

偵聽程式會接收事件以指出上傳的進度、成功或失敗。雖然您可以使用 FileReferenceList 物件，讓使用者選取多個要上傳的檔案，不過必須一次上傳一個檔案。若要這樣做，請重複執行 FileReference 物件的 FileReferenceList.fileList 陣列。

檔案會上傳到在 url 參數中傳遞的 URL。 URL 必須是設定為可以接受上傳的伺服器程式碼。 Flash Player 會使用 HTTP POST 方法來上傳檔案。處理上傳的伺服器程式碼應該要有包含下列元素的 POST 要求：

Content-Type (屬於 multipart/form-data
name 特質預設為 "Filedata" 且 filename 特質設為原始檔案名稱的 Content-Disposition)
檔案的二進位內容

您不可以連接到常用的保留連接埠。完整的封鎖連接埠清單，請參閱在「ActionScript 3.0 開發人員指南」中的「限制網路 API」。

如需 POST 要求的樣本，請參閱 uploadDataFieldName 參數的說明。您可以使用 upload() 方法，將 POST 或 GET 參數傳送至伺服器，請參閱 request 參數的說明。

如果 testUpload 參數為 true，而且要上傳的檔案超過約 10 KB，則在上傳實際的檔案之前，Windows 上的 Flash Player 會先傳送內容為零的測試上傳 POST 作業，以便確認傳輸是否可成功。然後，Flash Player 會傳送包含實際檔案內容的第二個 POST 作業。若為小於 10 KB 的檔案，Flash Player 就會以要上傳的實際檔案內容，執行單一上傳 POST。 Macintosh 上的 Flash Player 並不會執行測試上傳 POST 作業。

使用此方法時，必須顧及 Flash Player 安全性模型：

如果呼叫的 SWF 檔位於不受信任的本機安全執行程序中，則不允許載入作業。
預設行為是拒絕安全執行程序之間的存取。但是網站可以新增 URL 原則檔，啟用對資源的存取。
您可以拒絕 SWF 檔使用這個方法，方式是在包含 SWF 內容的 HTML 網頁中，設定 object 和 embed 標籤的 allowNetworking 參數。

但在 Adobe AIR 中，application 安全執行程序中的內容 (使用 AIR 應用程式所安裝的內容) 沒有這些安全性限制。

如需安全性詳細資訊，請參閱「Flash Player 開發人員中心」主題：安全性。

參數

	`request:URLRequest` — URLRequest 物件。URLRequest 物件的 `url` 屬性應該包含設定為透過 HTTP `POST` 呼叫處理上傳之伺服器程式碼的 URL。在某些瀏覽器上，URL 字串有長度上的限制。長度超過 256 個字元，就可能在某些瀏覽器或伺服器上造成失敗。如果此參數為 `null`，就會擲回例外。 URLRequest 物件的 `requestHeaders` 屬性會被忽略；上傳或下載不支援自訂 HTTP 要求檔頭。 URL 可以是 HTTP，如果要執行安全上傳也可以是 HTTPS。若要使用 HTTPS，請在 `url` 參數中使用 HTTPS URL。如果您未在 `url` 參數中指定連接埠號，預設會針對 HTTP 使用連接埠 80 而針對 HTTPS 使用連接埠 443。若要將 `POST` 或 `GET` 參數傳送至伺服器，請將 URLRequest 物件的 `data` 屬性設定為您的參數，並將 `method` 屬性設定為 `URLRequestMethod.POST` 或 `URLRequestMethod.GET`。

	`uploadDataFieldName:String` (default = "`Filedata`") — 欄位名稱，位於上傳 `POST` 作業中的檔案資料前面。 `uploadDataFieldName` 必須是非 null 的值以及非空白的字串。根據預設，`uploadDataFieldName` 的值為 `"Filedata"`，如下列 `POST` 要求樣本所示： Content-Type: multipart/form-data; boundary=AaB03x --AaB03x Content-Disposition: form-data; name="Filedata"; filename="example.jpg" Content-Type: application/octet-stream ... contents of example.jpg ... --AaB03x--

	`testUpload:Boolean` (default = `false`) — 要求測試檔案上傳的設定。當 `testUpload` 是設定為 `true` 時，對於大於 10 KB 的檔案，Flash Player 會以內容長度為 0 測試檔案上傳 `POST`。測試上傳作業可檢查實際檔案上傳是否能夠成功，以及 (需要時) 伺服器驗證是否能成功。測試上傳作業僅適用於 Windows 播放程式。

事件

	`open:Event` — 在上傳作業開始時傳送。

	`progress:ProgressEvent` — 在檔案上傳作業期間定期傳送。

	`complete:Event` — 在檔案上傳作業順利完成時傳送。

	`uploadCompleteData:DataEvent` — 在成功上傳檔案之後，從伺服器接收資料時傳送。

	`securityError:SecurityErrorEvent` — 在上傳基於安全性違規而失敗時傳送。

	`httpStatus:HTTPStatusEvent` — 在上傳基於 HTTP 錯誤而失敗時傳送。

	`httpResponseStatus:HTTPStatusEvent` — 上傳作業成功完成，而且伺服器傳回回應 URL 和回應標頭。

	`ioError:IOErrorEvent` — 在下列任一情況下叫用：由於在 Flash Player 或 Adobe AIR 讀取、寫入或傳送檔案時發生輸入/輸出錯誤，導致上傳失敗。由於嘗試上傳檔案至需要驗證 (如使用者名稱和密碼) 的伺服器，導致上傳失敗。上傳期間，未提供讓使用者輸入密碼的工具。因為 `url` 參數包含無效的通訊協定而導致上傳失敗。`FileReference.upload()` 必須使用 HTTP 或 HTTPS。

擲回值

	`SecurityError` — 本機不受信任的 SWF 檔可能無法與網際網路進行通訊。若要避免這種情況，請將此 SWF 檔重新分類為「具有網路連線的本機」或受信任。擲回例外時會出現訊息，指出無法存取的本機檔案名稱和 URL。

	`SecurityError` — 您不可以連接到常用的保留連接埠。完整的封鎖連接埠清單，請參閱在「ActionScript 3.0 開發人員指南」中的「限制網路 API」。

	`IllegalOperationError` — 會在下列情況下擲回：1) 另一個 FileReference 或 FileReferenceList 瀏覽工作階段正在處理中。一次只能執行一個檔案瀏覽工作階段。 2) 該 URL 參數不是有效的路徑或通訊協定。檔案上傳必須使用 HTTP，而且檔案下載必須使用 FTP 或 HTTP。 3) `uploadDataFieldName` 參數設定為 `null`。 4) 使用者之 mms.cfg 檔案中的設定禁止了這項作業。

	`ArgumentError` — 會在下列情況下擲回：1) `uploadDataFieldName` 參數是空字串。 2) `url.data` 的類型為 ByteArray。若要搭配 `FileReference.upload()` 和 `FileReference.download()` 方法使用，`url.data` 的類型只能是 URLVariables 或 String。3) 在 AIR 執行階段中 (在應用程式安全執行程序中)，URLRequest 的方法不是 GET 或 POST (請改用 `uploadEncoded()`)。

	`MemoryError` — 這項錯誤可能會因為下列原因而發生：1) Flash Player 無法將 `URLRequest.data` 參數從 UTF8 轉換成 MBCS。如果傳遞給 `FileReference.upload()` 的 URLRequest 物件設定為執行 GET 作業，而且 `System.useCodePage` 設定為 `true`，就會發生這項錯誤。 2) Flash Player 無法分配 `POST` 資料的記憶體。如果傳遞給 `FileReference.upload()` 的 URLRequest 物件設定為執行 `POST` 作業，就會發生這項錯誤。

uploadUnencoded

()

方法

public function uploadUnencoded(request:URLRequest):void

執行階段版本:

AIR 1.0

不使用任何編碼，起始上傳檔案至 URL。upload() 方法會使用 form-data 封套編碼檔案，而 uploadUnencoded() 方法會以 HTTP 要求內文相同的格式傳遞檔案內容。如果您想要傳送的資料已經以接收伺服器可瞭解的格式進行編碼，則使用 uploadUnencoded() 方法。一般搭配 HTTP/WebDAV PUT 方法使用 uploadeUnencoded() 方法。

參數

request:URLRequest — URLRequest 物件。URLRequest 物件的 url 屬性應該包含設定為透過 HTTP POST 呼叫處理上傳之伺服器程式碼的 URL。在某些瀏覽器上，URL 字串有長度上的限制。長度超過 256 個字元，就可能在某些瀏覽器或伺服器上造成失敗。如果此參數為 null，就會擲回例外。

URL 可以是 HTTP，如果要執行安全上傳也可以是 HTTPS。若要使用 HTTPS，請在 url 參數中使用 HTTPS URL。如果您未在 url 參數中指定連接埠號，預設會針對 HTTP 使用連接埠 80 而針對 HTTPS 使用連接埠 443。

若要將 POST 或 GET 參數傳送至伺服器，請將 URLRequest 物件的 data 屬性設定為您的參數，並將 method 屬性設定為 URLRequestMethod.POST 或 URLRequestMethod.GET。

事件

	`open:Event` — 在上傳作業開始時傳送。

	`progress:ProgressEvent` — 在檔案上傳作業期間定期傳送。

	`complete:Event` — 在檔案上傳作業順利完成時傳送。

	`uploadCompleteData:DataEvent` — 在成功上傳檔案之後，從伺服器接收資料時傳送。

	`securityError:SecurityErrorEvent` — 在上傳基於安全性違規而失敗時傳送。

	`httpStatus:HTTPStatusEvent` — 在上傳基於 HTTP 錯誤而失敗時傳送。

	`httpResponseStatus:HTTPStatusEvent` — 上傳作業成功完成，而且伺服器傳回回應 URL 和回應標頭。

	`ioError:IOErrorEvent` — 在下列任一情況下叫用：因為在 Adobe AIR 讀取、寫入或傳送檔案時發生輸入/輸出錯誤，導致上傳失敗。由於嘗試上傳檔案至需要驗證 (如使用者名稱和密碼) 的伺服器，導致上傳失敗。上傳期間，未提供讓使用者輸入密碼的工具。因為 `url` 參數包含無效的通訊協定而導致上傳失敗。`FileReference.upload()` 必須使用 HTTP 或 HTTPS。

擲回值

	`SecurityError` — 本機不受信任的 SWF 檔可能無法與網際網路進行通訊。若要避免這種情況，請將此 SWF 檔重新分類為「具有網路連線的本機」或受信任。擲回例外時會出現訊息，指出無法存取的本機檔案名稱和 URL。

	`IllegalOperationError` — 會在下列情況下擲回：1) 另一個 FileReference 或 FileReferenceList 瀏覽工作階段正在處理中。一次只能執行一個檔案瀏覽工作階段。 2) 該 URL 參數不是有效的路徑或通訊協定。檔案上傳必須使用 HTTP。

事件詳細資訊

cancel

事件

事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.CANCEL

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

在使用者透過檔案瀏覽對話方塊取消檔案上傳或載入作業時傳送。如果使用者透過其它方法 (關閉瀏覽器或停止目前的應用程式) 取消上傳或下載，則 Flash Player 不會傳送此事件。

Event.CANCEL 常數會定義 cancel 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	在其上取消作業之物件的參照。

範例 ( 如何使用本範例 )

下列範例說明 cancel 事件物件的使用方式。如果要執行這個範例，請變更 downloadURL.url 屬性，將它指向實際的網域和檔案，而不是虛構的 http://www.[yourDomain].com/SomeFile.pdf。您可能還需要編譯 SWF 檔，並將「本機播放安全性」設定為「只存取網路」，或更新 Flash Player 安全性設定，以便允許此檔案進行網路存取。

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class FileReference_event_cancel extends Sprite {
        private var downloadURL:URLRequest;
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function FileReference_event_cancel() {
            downloadURL = new URLRequest();
            downloadURL.url = "http://www.[yourDomain].com/SomeFile.pdf";
            file = new FileReference();
            file.addEventListener(Event.CANCEL, cancelHandler);
            file.download(downloadURL, fileName);
        }
        private function cancelHandler(event:Event):void {
            trace("cancelHandler: " + event);
        }
    }
}

complete

事件

事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.COMPLETE

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

在下載完成或上傳產生 HTTP 狀態碼 200 時傳送。若為檔案下載，這個事件會在 Flash Player 或 Adobe AIR 完成將整個檔案下載至磁碟時傳送。若為檔案上傳，這個事件會在 Flash Player 或 Adobe AIR 從接收傳輸的伺服器收到 HTTP 狀態碼 200 之後傳送。

Event.COMPLETE 常數會定義 complete 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已完成載入的網路物件。

範例 ( 如何使用本範例 )

下列範例說明 complete 事件物件的使用方式。如果要執行這個範例，請變更 downloadURL.url 屬性，將它指向實際的網域和檔案，而不是虛構的 http://www.[yourDomain].com/SomeFile.pdf。您可能還需要編譯 SWF 檔，並將「本機播放安全性」設定為「只存取網路」，或更新 Flash Player 安全性設定，以便允許此檔案進行網路存取。

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class FileReference_event_complete extends Sprite {
        private var downloadURL:URLRequest;
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function FileReference_event_complete() {
            downloadURL = new URLRequest();
            downloadURL.url = "http://www.[yourDomain].com/SomeFile.pdf";
            file = new FileReference();
            configureListeners(file);
            file.download(downloadURL, fileName);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.CANCEL, cancelHandler);
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(Event.SELECT, selectHandler);
        }

        private function cancelHandler(event:Event):void {
            trace("cancelHandler: " + event);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + downloadURL.url);
        }
    }
}

httpResponseStatus

事件

事件物件類型: flash.events.HTTPStatusEvent
屬性 HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, AIR 1.0

當 upload() 或 uploadUnencoded() 方法呼叫嘗試透過 HTTP 存取資料，而且 Adobe AIR 能夠偵測並傳回要求的狀態碼時傳送。

與 httpStatus 事件不同，httpResponseStatus 事件在傳送任何回應資料之前會行先傳送。此外，httpResponseStatus 事件也包含 responseHeaders 和 responseURL 屬性的值 (尚未針對 httpStatus 事件而定義)。請注意，httpResponseStatus (如果有的話) 將在 (另外) 任何 complete 或 error 事件之前傳送。

HTTPStatusEvent.HTTP_RESPONSE_STATUS 常數會定義 httpResponseStatus 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`responseURL`	傳回回應的 URL。
`responseHeaders`	回應所傳回 (做為 URLRequestHeader 物件的陣列) 的回應檔頭。
`status`	伺服器傳回的 HTTP 狀態碼。
`redirected`	回應是否為重新導向的結果。
`target`	接收 HTTP 狀態碼的網路物件。

相關 API 元素

upload()
uploadUnencoded()

httpStatus

事件

事件物件類型: flash.events.HTTPStatusEvent
屬性 HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

在上傳失敗時傳送，而且 HTTP 狀態碼可用於描述失敗。 httpStatus 事件會先傳送，然後再傳送 ioError 事件。

httpStatus 事件只會針對上傳失敗傳送。對於 Flash Player 中執行的內容，這個事件不適用於下載失敗。如果因為 HTTP 錯誤而造成下載失敗，則該錯誤會回報為 I/O 錯誤。

HTTPStatusEvent.HTTP_STATUS 常數會定義 httpStatus 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`status`	伺服器傳回的 HTTP 狀態碼。
`target`	接收 HTTP 狀態碼的網路物件。

相關 API 元素

FileReference.upload()

ioError

事件

事件物件類型: flash.events.IOErrorEvent
屬性 IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

在上傳或下載失敗時傳送。檔案傳輸可能會因為下列其中一個原因而失敗：

播放程式讀取或傳送檔案時發生輸入/輸出錯誤。
SWF 檔嘗試上傳檔案至需要驗證 (例如使用者名稱和密碼) 的伺服器。上傳期間，Flash Player 或 Adobe AIR 沒有提供讓使用者輸入密碼的工具。如果 SWF 檔嘗試上傳檔案至需要驗證的伺服器，則上傳會失敗。
在獨立或外部播放程式中，SWF 檔嘗試從需要驗證的伺服器下載檔案。下載期間，獨立和外部播放程式沒有提供讓使用者輸入密碼的工具。如果這些播放程式內的 SWF 檔嘗試自需要驗證的伺服器下載檔案，則下載會失敗。只有在 ActiveX 控制項、瀏覽器外掛播放程式和 Adobe AIR 執行階段中，檔案下載才會成功。
在 upload() 方法中傳遞給 url 參數的值含有無效的通訊協定。有效的通訊協定為 HTTP 和 HTTPS。

重要：只有在瀏覽器中執行 (也就是使用瀏覽器外掛程式或 ActiveX 控制項) 的應用程式以及在 Adobe AIR 中執行的內容，才能提供對話方塊，以提示使用者輸入可供驗證且僅供下載之用的使用者名稱和密碼。如果使用外掛程式或 ActiveX 控制項版本的 Flash Player 上傳，或是使用獨立或外部播放程式進行上傳或下載，則檔案傳輸會失敗。

定義 ioError 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`errorID`	與特定錯誤相關聯的參考號碼 (僅限 AIR)。
`target`	遭遇輸入/輸出錯誤的網路物件。
`text`	要顯示為錯誤訊息的文字。

open

事件

事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.OPEN

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

在上傳或下載作業開始時傳送。

Event.OPEN 常數會定義 open 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已開啟連線的網路物件。

範例 ( 如何使用本範例 )

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;
    import flash.net.FileFilter;

    public class FileReference_download extends Sprite {
        private var downloadURL:URLRequest;
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function FileReference_download() {
            downloadURL = new URLRequest();
            downloadURL.url = "http://www.[yourDomain].com/SomeFile.pdf";
            file = new FileReference();
            configureListeners(file);
            file.download(downloadURL, fileName);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.CANCEL, cancelHandler);
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(Event.SELECT, selectHandler);
        }

        private function cancelHandler(event:Event):void {
            trace("cancelHandler: " + event);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + downloadURL.url);
        }
    }
}

permissionStatus

事件

事件物件類型: flash.events.PermissionEvent
屬性 PermissionEvent.type = flash.events.PermissionEvent.PERMISSION_STATUS

語言版本:

ActionScript 3.0

執行階段版本:

AIR 24.0

當應用程式要求權限以存取檔案系統時傳送。檢查 status 屬性的值，以判斷是否已授與或拒絕權限

progress

事件

事件物件類型: flash.events.ProgressEvent
屬性 ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

在檔案上傳或下載作業期間定期傳送。 progress 事件會在 Flash Player 傳送位元組至伺服器時傳送，而且它會在傳輸期間定期傳送，即使這個傳輸作業最後沒有成功也一樣。若要判斷檔案傳輸是否實際成功以及完成的時間，請偵聽 complete 事件。

在某些情況下，並不會收到 progress 事件。例如，如果傳輸的檔案非常小，或者上傳或下載發生的時間非常快速，可能就不會傳送 progress 事件。

早於 OS X 10.3 版的 Macintosh 平台無法判斷檔案上傳進度。雖然在上傳作業期間會呼叫 progress 事件，但 progress 事件的 bytesLoaded 屬性值為 -1，表示無法判斷進度。

定義 progress 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`bytesLoaded`	在偵聽程式處理事件時，載入的項目或位元組數目。
`bytesTotal`	如果載入程序成功時，最終將載入的項目或位元組總數。
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	回報進度的物件。

範例 ( 如何使用本範例 )

下列範例說明 progress 事件的使用方式。如果要執行這個範例，請變更 downloadURL.url 屬性，將它指向實際的網域和檔案，而不是虛構的 http://www.[yourDomain].com/SomeFile.pdf。您可能還需要編譯 SWF 檔，並將「本機播放安全性」設定為「只存取網路」，或更新 Flash Player 安全性設定，以便允許此檔案進行網路存取。

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class FileReference_event_progress extends Sprite {
        private var downloadURL:URLRequest;
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function FileReference_event_progress() {
            downloadURL = new URLRequest();
            downloadURL.url = "http://www.[yourDomain].com/SomeFile.pdf";
            file = new FileReference();
            file.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            file.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            file.addEventListener(Event.COMPLETE, completeHandler);
            file.download(downloadURL, fileName);
        }

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }
        
        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
        
        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }
    }
}

securityError

事件

事件物件類型: flash.events.SecurityErrorEvent
屬性 SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

會在 FileReference.upload() 或 FileReference.download() 方法的呼叫嘗試將檔案上傳至伺服器，或從呼叫者安全執行程序以外的伺服器取得檔案時傳送。描述發生之特定錯誤的 text 屬性值通常會是 "securitySandboxError"。進行呼叫的 SWF 可能已嘗試存取其網域外的 SWF，不過並未得到允許。您可以使用 URL 原則檔案來嘗試補救此錯誤。

在 Adobe AIR 中，這些安全性限制不適用於應用程式安全執行程序中的內容。

SecurityErrorEvent.SECURITY_ERROR 常數會定義 securityError 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	回報安全性錯誤的網路物件。
`text`	要顯示為錯誤訊息的文字。

select

事件

事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.SELECT

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9

在使用者從檔案瀏覽對話方塊中，選取要上傳或下載的檔案時傳送。(這個對話方塊會在您呼叫 FileReference.browse()、FileReferenceList.browse() 或 FileReference.download() 方法時開啟)。當使用者選取檔案並確認作業時 (例如，按一下「確定」)，就會填入 FileReference 物件的屬性。

針對 Flash Player 中執行的內容或在 Adobe AIR 執行階段中 (但在應用程式安全執行程序外) 執行的內容，select 事件的動作會根據叫用它的方法稍微不同。如果 select 事件是在呼叫 browse() 之後傳送，Flash Player 或 AIR 應用程式就可以讀取 FileReference 物件的所有屬性，因為使用者選取的檔案是在本機檔案系統上。如果 select 事件是在呼叫 download() 之後傳送，Flash Player 或 AIR 應用程式則只能讀取 name 屬性，因為在傳送 select 事件的當時，檔案尚未下載到本機檔案系統中。如果已經下載檔案並已經傳送 complete 事件，那麼 Flash Player 或 AIR 應用程式就可以讀取 FileReference 物件的所有其它屬性。

Event.SELECT 常數會定義 select 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	已經選取項目的物件。

範例 ( 如何使用本範例 )

下列範例說明 select 事件物件的使用方式。若要執行這個範例，請變更 uploadURL.url 屬性，將它指向實際的網域和檔案，而不是虛構的 http://www.[yourDomain].com/SomeFile.pdf。您可能還需要編譯 SWF 檔，並將「本機播放安全性」設定為「只存取網路」，或更新 Flash Player 安全性設定，以便允許此檔案進行網路存取。若要讓這個範例從桌上型電腦執行，您的伺服器也必須具有 crossdomain.xml 檔案。如果觸發了 ioErrorHandler() 函數，您可能必須以設定為接收上傳的有效 URL 來更新提供的 uploadURL。

 
package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class FileReference_event_select extends Sprite {
        private var uploadURL:URLRequest;
        private var file:FileReference;

        public function FileReference_event_select() {
            uploadURL = new URLRequest();
            uploadURL.url = "http://www.[yourDomain].com/yourUploadHandlerScript.cfm";
            file = new FileReference();
            file.addEventListener(Event.SELECT, selectHandler);
            file.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            file.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            file.addEventListener(Event.COMPLETE, completeHandler);
            file.browse();
        }

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + uploadURL.url);
            file.upload(uploadURL);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }
    }
}

uploadCompleteData

事件

事件物件類型: flash.events.DataEvent
屬性 DataEvent.type = flash.events.DataEvent.UPLOAD_COMPLETE_DATA

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9.0.28.0

在成功上傳後，從伺服器接到資料以後傳送。如果未從伺服器傳回資料，則不傳送此事件。

定義的 type 屬性值 (uploadCompleteData 事件物件)。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`data`	成功上載檔案以後，從伺服器傳回的原始資料。
`target`	成功上載以後，接收資料的 FileReference 物件。

範例如何使用本範例

FileReferenceExample.as

下列範例會顯示在執行階段下載之檔案的資料格式和狀態資訊。

注意： 如果要執行這個範例，請變更 uploadURL.url 屬性，將它指向實際的 URL，而不是範例中的虛構 URL。 URL 應該指向 URL 指定之網站根目錄中的 yourUploadHandlerScript.cfm。根據您的設定，可能還需要編譯 SWF 檔，並將「本機播放安全性」設定為「只存取網路」，或更新 Flash Player 安全性設定，以允許此檔案進行網路存取。

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileFilter;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class FileReferenceExample extends Sprite {
        private var uploadURL:URLRequest;
        private var file:FileReference;

        public function FileReferenceExample() {
            uploadURL = new URLRequest();
            uploadURL.url = "http://www.[yourDomain].com/yourUploadHandlerScript.cfm";
            file = new FileReference();
            configureListeners(file);
            file.browse(getTypes());
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.CANCEL, cancelHandler);
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(Event.SELECT, selectHandler);
            dispatcher.addEventListener(DataEvent.UPLOAD_COMPLETE_DATA,uploadCompleteDataHandler);
        }

        private function getTypes():Array {
            var allTypes:Array = new Array(getImageTypeFilter(), getTextTypeFilter());
            return allTypes;
        }

        private function getImageTypeFilter():FileFilter {
            return new FileFilter("Images (*.jpg, *.jpeg, *.gif, *.png)", "*.jpg;*.jpeg;*.gif;*.png");
        }

        private function getTextTypeFilter():FileFilter {
            return new FileFilter("Text Files (*.txt, *.rtf)", "*.txt;*.rtf");
        }

        private function cancelHandler(event:Event):void {
            trace("cancelHandler: " + event);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }

        private function uploadCompleteDataHandler(event:DataEvent):void {
            trace("uploadCompleteData: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }
        
        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + uploadURL.url);
            file.upload(uploadURL);
        }
    }
}

法律聲明 | 線上隱私權政策

FileReference - AS3

套件x

語言元素

附錄

套件 flash.net

creationDate

creator

data

extension

modificationDate

name

permissionStatus

size

type

FileReference

browse

cancel

download

load

requestPermission

save

upload

uploadUnencoded

cancel

complete

httpResponseStatus

httpStatus

ioError

open

permissionStatus

progress

securityError

select

uploadCompleteData