flash.errors
public dynamic class EOFError
继承EOFError Inheritance IOError Inheritance Error Inheritance Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

如果尝试读取的内容超出可用数据的末尾,则会引发 EOFError 异常。例如,当调用 IDataInput 接口中的一个读取方法,而数据不足以满足读取请求时,将引发 EOFError。

查看示例

另请参见

flash.utils.ByteArray
flash.utils.IDataInput
flash.net.Socket
flash.net.URLStream
Working with the debugger versions of Flash Player and AIR
flash.error package Error classes


公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritederrorID : int
[只读 (read-only)] 包含与特定错误消息相关联的引用编号。
Error
 Inheritedmessage : String
包含与 Error 对象关联的消息。
Error
 Inheritedname : String
包含 Error 对象的名称。
Error
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
公共方法
 方法定义方
  
EOFError(message:String = "")
创建新的 EOFError 对象。
EOFError
 Inherited
在构造错误时,以字符串形式返回错误的调用堆栈(仅适用于 Flash Player 的调试版和 AIR Debug Launcher (ADL));如果未使用 Flash Player 的调试版或 ADL,则返回 null。
Error
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
默认情况下,返回字符串“Error”;如果已定义,则返回 Error.message 属性中包含的值。
Error
 Inherited
返回指定对象的原始值。
Object
构造函数详细信息
EOFError()构造函数
public function EOFError(message:String = "")

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

创建新的 EOFError 对象。

参数
message:String (default = "") — 与此错误对象相关联的字符串。
示例 如何使用示例
EOFErrorExample.as

下例使用 EOFErrorExample 类显示尝试读取的内容超出了可用数据的末尾时生成的错误。这是由以下步骤完成的:
  1. 构造函数创建一个 ByteArray 对象 byteArr,并使用 writeBoolean()false 的布尔值写入字节流。
  2. byteArr 的位置被重置为 0(数据流的开始处)。
  3. 使用 readBoolean() 从数据流中删除单个字节。数据流现在未包含任何数据。
  4. 在设置为捕获 EOFError 对象的错误处理代码段中,将再次调用 readBoolean(),捕获 EOFError 并将它传递到 trace() 语句,这样便会输出与 EOFError 对象关联的错误消息。
package {
    import flash.display.Sprite;
    import flash.errors.EOFError;
    import flash.utils.ByteArray;

    public class EOFErrorExample extends Sprite {        
        public function EOFErrorExample() {
            var byteArr:ByteArray = new ByteArray();

            byteArr.writeBoolean(false);
            trace(byteArr.length);        // 1
            
            byteArr.position = 0;
            try {
                trace(byteArr.readBoolean());    // false
            }
            catch(e:EOFError) {
                trace(e);
            }
            try {
                trace(byteArr.readBoolean());
            } 
            catch(e:EOFError) {
                trace(e);        // EOFError: Error #2030: End of file was encountered.
            }
        }
    }
}