Error (Flex 3.2)

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

	方法	定义方
		Error(message:String = "", id:int = 0) 创建新的 Error 对象。	Error
		getStackTrace():String 在构造错误时，以字符串形式返回错误的调用堆栈（仅适用于 Flash Player 的调试版和 AIR Debug Launcher (ADL)）；如果未使用 Flash Player 的调试版或 ADL，则返回 null。	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

运行时版本:

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 属性。

另请参见

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

name

属性

public var name:String

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0 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

运行时版本:

AIR 1.0 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

运行时版本:

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.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.as

以下示例使用 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);
    }
}

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
Error	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例

包	顶级
类	public dynamic class Error
继承	Error 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