Error (ActionScript 3.0)

	属性	定义方
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		errorID : int [read-only] 包含与特定错误消息相关联的引用编号。	Error
		message : String 包含与 Error 对象关联的消息。	Error
		name : String 包含 Error 对象的名称。	Error
		prototype : Object [static] 对类或函数对象的原型对象的引用。	Object

	方法	定义方
		Error(message:String = "", id:int = 0) 创建新的 Error 对象。	Error
		getStackTrace():String 在构造错误时，以字符串形式返回错误的调用堆栈（仅适用于 Flash Player 的调试版）。	Error
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toString():String 默认情况下，返回字符串 "Error"；如果已定义，则返回 Error.message 属性中包含的值。	Error
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

errorID

属性

errorID:int [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

实现
public function get errorID():int

message

属性

public var message:String

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

另请参见

statements.html#throw
statements.html#try..catch..finally

name

属性

public var name:String

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

另请参见

statements.html#throw
statements.html#try..catch..finally

构造函数详细信息

Error

()

构造函数

public function Error(message:String = "", id:int = 0)

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

参数

	`message:String` (default = "") — 与 Error 对象关联的字符串；此参数为可选。

	`id:int` (default = `0`) — 与特定错误消息关联的引用数字。

另请参见

statements.html#throw
statements.html#try..catch..finally

示例
如何使用示例

下例创建一个新的 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

Player 版本 :

Flash Player 9

在构造错误时，以字符串形式返回错误的调用堆栈（仅适用于 Flash Player 的调试版）。如下面的示例所示，返回值的第一行是异常对象的字符串表示形式，后跟堆栈跟踪元素：

  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

()

方法

public override function toString():String

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

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

String — 错误消息。

另请参见

Error.message
statements.html#throw
statements.html#try..catch..finally

示例
如何使用示例

下例创建一个新的 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 类说明如何生成自定义错误。这是由以下步骤完成的：

声明一个 Array 类型的局部变量 nullArray，但是请注意，从未创建新的 Array 对象。
构造函数尝试在错误处理代码段中使用 push() 方法将值加载到未初始化的数组中，该代码段使用 CustomError 类捕获自定义错误，该类扩展 Error。
引发 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);
    }
}

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/Error.html

ActionScript 3.0 语言和组件参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 帧无帧
Error	属性 \| 方法 \| 示例

包	顶级
类	public dynamic class Error
继承	Error Object
子类	ArgumentError, DefinitionError, EvalError, IllegalOperationError, InvalidSWFError, IOError, MemoryError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, StackOverflowError, SyntaxError, TypeError, URIError, VerifyError, VideoError