套件 | flash.events |
類別 | public class IOErrorEvent |
繼承 | IOErrorEvent ErrorEvent TextEvent Event Object |
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
您可以使用除錯程式版本的 Flash Player 或 AIR Debug Launcher (ADL) 來檢查沒有任何偵聽程式的 error 事件。如此便會傳送 IOErrorEvent 建構函式的 text
參數。
相關 API 元素
公用方法
方法 | 定義自 | ||
---|---|---|---|
IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
建立包含 ioError 事件特定資訊的 Event 物件。 | IOErrorEvent | ||
[覆寫]
建立 IOErrorEvent 物件的副本,然後設定每個屬性值以符合原始物件的屬性值。 | IOErrorEvent | ||
公用程式函數,可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。 | Event | ||
指出物件是否有已定義的指定屬性。 | Object | ||
檢查是否已經對事件呼叫 preventDefault() 方法。 | Event | ||
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | ||
如果可以取消事件的預設行為指令,則取消該行為指令。 | Event | ||
指出指定的屬性是否存在,以及是否可列舉。 | Object | ||
為迴圈作業設定動態屬性的可用性。 | Object | ||
避免處理事件流程中,目前節點以及任何後續節點中的任何事件偵聽程式。 | Event | ||
避免處理接續在事件流程中的目前節點之後,後續節點中的任何事件偵聽程式。 | Event | ||
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | ||
[覆寫]
傳回包含 IOErrorEvent 物件所有屬性的字串。 | IOErrorEvent | ||
會傳回指定之物件的基本值。 | Object |
公用常數
常數 | 定義自 | ||
---|---|---|---|
IO_ERROR : String = "ioError" [靜態]
定義 ioError 事件物件的 type 屬性值。 | IOErrorEvent | ||
STANDARD_ERROR_IO_ERROR : String = "standardErrorIoError" [靜態]
從 NativeProcess 物件的 standardError 串流讀取資料時,如果發生錯誤,將會傳送 standardErrorIoError 事件。 | IOErrorEvent | ||
STANDARD_INPUT_IO_ERROR : String = "standardInputIoError" [靜態]
寫入資料到 NativeProcess 物件的 standardInput 時,如果發生錯誤,將會傳送 standardInputIoError 事件。 | IOErrorEvent | ||
STANDARD_OUTPUT_IO_ERROR : String = "standardOutputIoError" [靜態]
從 NativeProcess 物件的 standardOutput 串流讀取資料時,如果發生錯誤,將會傳送 standardOutputIoError 事件。 | IOErrorEvent |
建構函式詳細資料
IOErrorEvent | () | 建構函式 |
public function IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
建立包含 ioError
事件特定資訊的 Event 物件。 Event 物件會當做參數傳遞至事件偵聽程式。
type:String — 事件類型。事件偵聽程式可以透過繼承的 type 屬性來存取此資訊。只有一種輸入/輸出錯誤事件:IOErrorEvent.IO_ERROR 。
| |
bubbles:Boolean (default = false ) — 判斷 Event 物件是否參與事件流程的反昇階段。事件偵聽程式可以透過繼承的 bubbles 屬性來存取此資訊。
| |
cancelable:Boolean (default = false ) — 判斷是否可以取消 Event 物件。事件偵聽程式可以透過繼承的 cancelable 屬性來存取此資訊。
| |
text:String (default = " ") — 要顯示為錯誤訊息的文字。 事件偵聽程式可以透過 text 屬性來存取此資訊。
| |
id:int (default = 0 ) — 要與特定錯誤產生關聯的參考號碼 (只有 Adobe AIR 才支援)。
|
相關 API 元素
方法詳細資訊
clone | () | 方法 |
toString | () | 方法 |
常數詳細資訊
IO_ERROR | 常數 |
public static const IO_ERROR:String = "ioError"
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
定義 ioError
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | false |
cancelable | false ;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
errorID | 與特定錯誤相關聯的參考號碼 (僅限 AIR)。 |
target | 遭遇輸入/輸出錯誤的網路物件。 |
text | 要顯示為錯誤訊息的文字。 |
相關 API 元素
STANDARD_ERROR_IO_ERROR | 常數 |
public static const STANDARD_ERROR_IO_ERROR:String = "standardErrorIoError"
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 2, Flash Lite 4 |
從 NativeProcess 物件的 standardError 串流讀取資料時,如果發生錯誤,將會傳送 standardErrorIoError
事件。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | 否。 |
cancelable | 否。沒有要取消的預設行為指令。 |
errorID | 與特定錯誤相關聯的參考號碼。 |
target | 發生錯誤的物件。 |
text | 要顯示為錯誤訊息的文字。 |
STANDARD_INPUT_IO_ERROR | 常數 |
public static const STANDARD_INPUT_IO_ERROR:String = "standardInputIoError"
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 2, Flash Lite 4 |
寫入資料到 NativeProcess 物件的 standardInput 時,如果發生錯誤,將會傳送 standardInputIoError
事件。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | 否。 |
cancelable | 否。沒有要取消的預設行為指令。 |
errorID | 與特定錯誤相關聯的參考號碼。 |
target | 發生錯誤的物件。 |
text | 要顯示為錯誤訊息的文字。 |
STANDARD_OUTPUT_IO_ERROR | 常數 |
public static const STANDARD_OUTPUT_IO_ERROR:String = "standardOutputIoError"
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 2, Flash Lite 4 |
從 NativeProcess 物件的 standardOutput 串流讀取資料時,如果發生錯誤,將會傳送 standardOutputIoError
事件。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | 否。 |
cancelable | 否。沒有要取消的預設行為指令。 |
errorID | 與特定錯誤相關聯的參考號碼。 |
target | 發生錯誤的物件。 |
text | 要顯示為錯誤訊息的文字。 |
範例 如何使用本範例
IOErrorEventExample.as
IOErrorEventExample
類別,以說明在嘗試載入不存在的檔案時,傳送錯誤事件物件的方式。 這個範例會執行下列工作:
- 類別建構函式會建立 URLLoader 物件的新實體,並將它指定給變數
loader
。 - URLLoader 實體會實體化一個
ioError
類型的事件偵聽程式,其具有相關訂閱者方法ioErrorHandler()
,會使用trace()
簡單地列出與事件有關的資訊。 - 接著建構函式會建立 URLRequest 物件的新實體
request
,傳入MissingFile.xml
,因此就會得知遺失的檔案名稱和位置。 - 然後,
request
變數會傳遞至loader.load()
,以嘗試載入遺失的檔案。 由於檔案已遺失,事件處理常式會傳送ioError
事件。
注意:
- 您必須將「本機播放安全性」設定為「只存取本機檔案」才能編譯 SWF 檔案。
- 請確定 SWF 檔案所在的同層目錄內沒有名為 "MissingFile.xml" 的檔案。
package { import flash.display.Sprite; import flash.events.IOErrorEvent; import flash.net.URLLoader; import flash.net.URLRequest; public class IOErrorEventExample extends Sprite { public function IOErrorEventExample() { var loader:URLLoader = new URLLoader(); loader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); var request:URLRequest = new URLRequest("MissingFile.xml"); loader.load(request); } private function ioErrorHandler(event:IOErrorEvent):void { trace("ioErrorHandler: " + event); } } }
Tue Jun 12 2018, 03:47 PM Z