Dictionary

套件	flash.utils
類別	public dynamic class Dictionary
繼承	Dictionary Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

Dictionary 類別能讓您建立屬性的動態集合，該集合會對識別碼比較使用嚴謹相等 (===)。當使用物件做為識別碼時，便會使用該物件的識別來查詢物件，而不會使用對物件呼叫 toString() 所傳回的值。

注意：您無法將 QName 物件當做 Dictionary 索引鍵使用。

下列陳述式會顯示 Dictionary 物件與識別碼物件之間的關係：

 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 元素

=== (嚴謹相等)

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		Dictionary(weakKeys:Boolean = false) 會建立新的 Dictionary 物件。	Dictionary
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		toJSON(k:String):* 提供可覆寫的方法，用於自訂 Dictionary 物件中值的 JSON 編碼。	Dictionary
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object

建構函式詳細資料

()

建構函式

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 識別碼。弱參照將不會從識別碼表格中移除，並且 Dictionary 將持續保留各個值的強參照，對 String 識別碼尤其如此。

方法詳細資訊

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:String — JSON.stringify() 在這個物件周遊中所遇到索引鍵值配對的索引鍵

傳回值

* — 類別名稱字串。

相關 API 元素

Object
Object.prototype

法律聲明 | 線上隱私權政策

Dictionary - AS3

類別 x

Dictionary

toJSON