RangeError

包	顶级
类	public dynamic class RangeError
继承	RangeError Error Object

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 9, AIR 1.0, Flash Lite 4

如果数值不在可接受的范围内，则会引发 RangeError 异常。使用数组时，引用不存在的数组项的索引位置将会引发 RangeError 异常。如果参数不在可接受的数字范围内，则使用 Number.toExponential()、Number.toPrecision() 和 Number.toFixed() 方法将引发 RangeError 异常。可以扩展 Number.toExponential()、Number.toPrecision() 和 Number.toFixed() 以避免引发 RangeError。

以下情况也可能引发此异常：

使用无效深度编号调用任何需要深度编号的 Flash 运行时 API。
使用无效帧编号调用任何需要帧编号的 Flash 运行时 API。
使用无效层编号调用任何需要层编号的 Flash 运行时 API。

查看示例

公共属性

隐藏继承的公共属性

显示继承的公共属性

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

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		RangeError(message:String = "") 创建一个新的 RangeError 对象。	RangeError
		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

构造函数详细信息

()

构造函数

public function RangeError(message:String = "")

运行时版本:

Flash Lite 4, Flash Player 9, AIR 1.0

创建一个新的 RangeError 对象。

参数

message:String (default = "") — 包含与 RangeError 对象关联的消息。

示例如何使用本示例

RangeErrorExample.as

下面的示例演示 RangeError 异常是如何生成的，以及如何在 try..catch 语句中进行处理。

package {
    import flash.display.Sprite;

    public class RangeErrorExample extends Sprite {

        public function RangeErrorExample() {
            var child:Sprite = new Sprite();
            try {
                addChildAt(child, 1);
            }
            catch(e:RangeError) {
                trace(e);
            }
        }
    }
}

法律声明 | 在线隐私策略

RangeError - AS3

类 x

RangeError