顶级
public dynamic class Error
继承Error Inheritance Object
子类 ArgumentError, AutomationError, CollectionViewError, CursorError, DefinitionError, DRMManagerError, EvalError, Fault, IllegalOperationError, InvalidCategoryError, InvalidFilterError, InvalidSWFError, IOError, ItemPendingError, MemoryError, MessagingError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, SortError, SQLError, StackOverflowError, SyntaxError, TypeError, URIError, VerifyError, VideoError

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

Error 类包含有关脚本中出现的错误的信息。开发 ActionScript 3.0 应用程序过程中,如果在 Flash Player 的调试版中运行已编译的代码,将弹出对话框显示 Error 类型的异常或子类异常,以帮助您排除代码中的故障。可以使用 Error 构造函数来创建 Error 对象。通常,将新的 Error 对象从 try 代码块中引发,然后由 catchfinally 代码块捕获。

您也可以创建 Error 类的子类,然后引发该子类的实例。

查看示例

另请参见

Working with the debugger versions of Flash Player and AIR
Creating custom error classes
Responding to error events and status


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

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

包含与特定错误消息相关联的引用编号。对于自定义的 Error 对象,此数字是构造函数中提供的 id 参数的值。



实现
    public function get errorID():int
message属性 
public var message:String

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

包含与 Error 对象关联的消息。默认情况下,此属性的值为“Error”。当通过将错误字符串传递给 Error 构造函数来创建 Error 对象时,可以指定 message 属性。

另请参见

name属性 
public var name:String

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

包含 Error 对象的名称。默认情况下,此属性的值为“Error”。

另请参见

构造函数详细信息
Error()构造函数
public function Error(message:String = "", id:int = 0)

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

创建新的 Error 对象。如果指定了 message,它的值将分配给对象的 Error.message 属性。

参数
message:String (default = "") — 与 Error 对象关联的字符串;此参数为可选。
 
id:int (default = 0) — 与特定错误消息关联的引用数字。

另请参见


示例

下例创建一个新的 Error 对象 err,然后使用 Error() 构造函数,将字符串 "New Error Message" 分配给 err

var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message
方法详细信息
getStackTrace()方法
public function getStackTrace():String

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

在构造错误时,以字符串形式返回错误的调用堆栈(仅适用于 Flash Player 的调试版和 AIR Debug Launcher (ADL));如果未使用 Flash Player 的调试版或 ADL,则返回 null。如下面的示例所示,返回值的第一行是异常对象的字符串表示形式,后跟堆栈跟踪元素:

  TypeError: null cannot be converted to an object
      at com.xyz.OrderEntry.retrieveData(OrderEntry.as:995)
      at com.xyz.OrderEntry.init(OrderEntry.as:200)
      at com.xyz.OrderEntry.$construct(OrderEntry.as:148)
     

返回
String — 调用堆栈的字符串表示形式。
toString()方法 
override public function toString():String

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

默认情况下,返回字符串 "Error";如果已定义,则返回 Error.message 属性中包含的值。

返回
String — 错误消息。

另请参见


示例

下例创建一个新的 Error 对象 err,然后使用 Error() 构造函数,将字符串 "New Error Message" 分配给 err。最后,将 message 属性设置为 "Another New Error Message",它将覆盖 "New Error Message"

var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message

err.message = "Another New Error Message";
trace(err.toString());    // Error: Another New Error Message
示例 如何使用示例
ErrorExample.as

以下示例使用 ErrorExample 类说明如何生成自定义错误。这是由以下步骤完成的:
  1. 声明一个 Array 类型的局部变量 nullArray,但是请注意,从未创建新的 Array 对象。
  2. 构造函数尝试在错误处理代码段中使用 push() 方法将值加载到未初始化的数组中,该代码段使用 CustomError 类捕获自定义错误,该类扩展 Error
  3. 引发 CustomError 时,构造函数将其捕获并输出一条错误消息(使用 trace() 语句)。
package
{
    import flash.display.Sprite;
    public class ErrorExample extends Sprite 
    {
        private var nullArray:Array;
        public function ErrorExample() 
        {
            try 
            {
                nullArray.push("item");
            }
            catch(e:Error) 
            {
                throw new CustomError("nullArray is null");
            }
        }
    }
}

class CustomError extends Error 
{
    public function CustomError(message:String) 
    {
        super(message);
    }
}