包 | 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)
创建一个 Event 对象,其中包含有关 ioError 事件的特定信息。 | 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 |
创建一个 Event 对象,其中包含有关 ioError
事件的特定信息。将 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 | () | 方法 |
override public function toString():String
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0, Flash Player 9, Flash Lite 4 |
返回一个字符串,其中包含 IOErrorEvent 对象的所有属性。字符串的格式如下:
[IOErrorEvent type=value bubbles=value cancelable=value text=value errorID=value]
errorId
仅在 Adobe AIR 中可用
String — 一个字符串,其中包含 IOErrorEvent 对象的所有属性。
|
常量详细信息
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, 11:04 AM Z