URLFilePromise  - AS3

套件	air.desktop
類別	public class URLFilePromise
繼承	URLFilePromise EventDispatcher Object
實作	IFilePromise

語言版本:

ActionScript 3.0

執行階段版本:

AIR 2.0

URLFilePromise 類別允許將 URL 上可以取得的資源拖離開 AIR 應用程式，變成一個檔案承諾。

URLFilePromise 類別會使用 URLStream 和 URLRequest 物件做為資料來源，實作 IFilePromise 介面。這種實作可以為那些使用 HTTP 便能擷取的檔案，或 URLStream 類別支援的其他通訊協定，提供拖放支援。

若要建立 URL 檔案承諾：

1. 建構以及初始化一或多個 URLFilePromise 物件。
2. 將 URLFilePromise 物件新增至陣列中。
3. 使用 ClipboardFormat (FILE_PROMISE_LIST)，將陣列新增至新的 Clipboard 物件。
4. 在回應使用者手勢時，呼叫 NativeDragManager startDrag() 方法，傳送內含檔案承諾陣列的 Clipboard 物件中。

當使用者完成拖曳作業，執行階段會為每一個檔案承諾下載資料。資料是從 URLFilePromise 物件的 request 屬性指定的 URL 進行存取，然後儲存至 relativePath 屬性指定的檔案中。儲存檔案的位置會相對於放置位置。因此，如果相對位置是 foo/bar.txt，並且將檔案承諾放置到稱為 home 的目錄中，則建立檔案的位置為：home/foo/bar.txt。發生錯誤時，不會建立檔案。

若要支援無法透過 URLStream 類別存取的資料來源，可以實作 IFilePromise 介面。

注意：AIR 執行階段會自動呼叫 IFilePromise 方法、open()、close() 以及 reportError()。您的應用程式邏輯絕對不應該呼叫這些方法。同樣地，此 URLFilePromise 物件傳送的 open、progress、complete 以及 close 事件，主要是用於除錯之目的。您的應用程式不需要回應這些事件。

此類別已包含在 aircore.swc 檔案中。Adobe^® Flash^™ Builder 會在您建立 Adobe^® AIR^™ 的專案時，自動載入這個類別。Adobe^® Flex^™ SDK 也會包含此 aircore.swc 檔案，如果您使用 Flex SDK，則編譯應用程式時就應該包含此檔案。

若要在 Adobe^® Flash^® Professional (CS4 或更新的版本) 中使用 air.desktop 套件：

1. 選取「檔案 > 發佈設定」命令。
2. 在 Flash 面板中，按一下 ActionScript 3.0 的「設定」按鈕，然後選取「元件庫路徑」。
3. 按一下「瀏覽至 SWC 檔案」按鈕。瀏覽至 Adobe Flash Professional 安裝資料夾中的 Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc 檔案。
4. 按一下「確定」按鈕。
5. 將下列 import 陳述式加入您的 ActionScript 3.0 程式碼：import air.desktop.*;

相關 API 元素

---