Error

包	顶级
类	public dynamic class Error
继承	Error Object
子类	ArgumentError, AugmentedError, AutomationError, CollectionViewError, ComplexCyclicDependencyError, Conflict, ConstraintError, CursorError, DataServiceError, DefinitionError, DRMManagerError, EvalError, ExpressionError, ExpressionEvaluationError, ExpressionValidationError, Fault, FormBridgeError, FunctionSequenceError, IllegalOperationError, InvalidCategoryError, InvalidFilterError, InvalidSWFError, IOError, ItemPendingError, MediaError, MemoryError, MessagingError, MetricError, NoDataAvailableError, PermissionError, PersistenceError, PersistenceError, ProxyServiceError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, SimpleCyclicDependencyError, SortError, SQLError, StackOverflowError, SyncManagerError, SyntaxError, TypeError, UnresolvedConflictsError, URIError, VerifyError, VideoError, VideoError

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

Error 类包含有关脚本中出现的错误的信息。在开发 ActionScript 3.0 应用程序时，当您在 Flash 运行时的调试版中运行已编译的代码时，将出现一个对话框，显示 Error 类型的异常或子类异常，以帮助您对代码进行故障诊断。可以使用 Error 构造函数来创建 Error 对象。通常，从 try 代码块内部引发一个新 Error 对象，该对象随后被 catch 代码块捕获。

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

查看示例

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		errorID : int [只读] 包含与特定错误消息相关联的引用编号。	Error
		message : String 包含与 Error 对象关联的消息。	Error
		name : String 包含 Error 对象的名称。	Error

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		Error(message:String = "", id:int = 0) 创建新的 Error 对象。	Error
		getStackTrace():String 在构建错误时，以字符串形式返回该错误的调用堆栈。	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
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String [覆盖] 默认情况下，返回字符串“Error”；如果已定义，则返回 Error.message 属性中包含的值。	Error
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

errorID

属性

errorID:int [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

实现
public function get errorID():int

message

属性

public var message:String

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

name

属性

public var name:String

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

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

构造函数详细信息

()

构造函数

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

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

创建新的 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 Lite 4

在构建错误时，以字符串形式返回该错误的调用堆栈。如以下示例所示，返回值的第一行是异常对象的字符串表示形式，后跟堆栈跟踪元素：

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()[/src/com/xyz/OrderEntry.as:995]
         at com.xyz::OrderEntry/init()[/src/com/xyz/OrderEntry.as:200]
         at com.xyz::OrderEntry()[/src/com/xyz/OrderEntry.as:148]

当被 Flash Player 调试版或 AIR Debug Launcher (ADL) 中运行的代码调用时，前面的清单可显示此方法的值。当代码在 Flash Player 发行版或 AIR 中运行时，将不会为堆栈跟踪提供文件路径和行号信息，如下面的示例所示：

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()
         at com.xyz::OrderEntry/init()
         at com.xyz::OrderEntry()

对于 Flash Player 11.4 和更低版本以及 AIR 3.4 和更低版本，只有在 Flash Player 调试版或 AIR Debug Launcher (ADL) 中运行代码时，才能使用堆栈跟踪。在非调试版的此类运行时中调用此方法将返回 null。

String — 调用堆栈的字符串表示形式。

toString

()

方法

override public function toString():String

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

默认情况下，返回字符串 "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 类说明如何生成自定义错误。这是由以下步骤完成的：

声明一个 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);
    }
}

法律声明 | 在线隐私策略

Error - AS3

类 x

errorID

message

name

Error

getStackTrace

toString