顶级
public dynamic class RangeError
继承RangeError Inheritance Error Inheritance Object

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

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

查看示例

另请参见

Number.toExponential()
Number.toPrecision()
Number.toFixed()
Error handling in ActionScript 3.0
Responding to error events and status


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

创建一个新的 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);
            }
        }
    }
}