用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
flash.utils 

Dictionary  - AS3

flash.utils
public dynamic class Dictionary
继承Dictionary Inheritance Object

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

Dictionary 类用于创建属性的动态集合,该集合使用 strict equality (===) 运算符进行键比较。将对象用作键时,会使用对象的标识来查找对象,而不是使用在对象上调用 toString() 所返回的值。

注意:不能将 QName 对象用作 Dictionary 键。

以下语句显示了一个 Dictionary 对象和一个 key 对象之间的关系:

 var dict = new Dictionary();
 var obj = new Object();
 var key:Object = new Object();
 key.toString = function() { return "key" }
 
 dict[key] = "Letters";
 obj["key"] = "Letters";
 
 dict[key] == "Letters"; // true
 obj["key"] == "Letters"; // true
 obj[key] == "Letters"; // true because key == "key" is true b/c key.toString == "key"
 dict["key"] == "Letters"; // false because "key" === key is false
 delete dict[key]; //removes the key
 

相关 API 元素



公共属性
 属性由以下参数定义
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
公共方法
 方法由以下参数定义
  
Dictionary(weakKeys:Boolean = false)
创建新的 Dictionary 对象。
Dictionary
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
  
提供一种可覆盖的方法,用于在 Dictionary 对象中自定义值的 JSON 编码。
Dictionary
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
构造函数详细信息

Dictionary

()构造函数
public function Dictionary(weakKeys:Boolean = false)

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

创建新的 Dictionary 对象。要从 Dictionary 对象中删除键,请使用 delete 运算符。

参数
weakKeys:Boolean (default = false) — 表示 Dictionary 对象在对象键上使用“弱”引用。如果对某个对象的唯一引用位于指定的 Dictionary 对象中,则键符合垃圾回收的条件,并且在回收对象时会被从表中删除。注意,Dictionary 绝不会从表中删除弱 String 键。特别是 String 键,弱引用绝不会从键表中被删除,并且 Dictionary 将保持对相应值的强引用。
方法详细信息

toJSON

()方法
public function toJSON(k:String):*

语言版本: ActionScript 3.0
运行时版本: Flash Player 11, AIR 3, Flash Lite 4

提供一种可覆盖的方法,用于在 Dictionary 对象中自定义值的 JSON 编码。

JSON.stringify() 方法在其遍历的每个对象上寻找 toJSON() 方法。如果找到 toJSON() 方法,JSON.stringify() 会为其遇到的每个值调用该方法,传入与值配对的密钥。

Dictionary 提供 toJSON() 的默认实现,该实现只返回类名称。希望将 Dictionary 对象导出到 JSON 的客户端必须提供其自己的 toJSON() 实现。通过重新定义类原型中的 toJSON() 方法可执行此操作。

toJSON() 方法可返回任何类型的值。如果返回一个对象,则 stringify() 会递归到该对象中。如果 toJSON() 返回一个字符串,则 stringify() 不会递归并继续其遍历。

参数

k:StringJSON.stringify() 在遍历此对象时遇到的密钥/值对的密钥

返回
* — 类名称字符串。

相关 API 元素

object
Object.prototype




[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。