ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.utils 

Dictionary  - AS3

Paketflash.utils
Klassepublic dynamic class Dictionary
VererbungDictionary Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Mit der Dictionary-Klasse können Sie eine dynamische Sammlung von Eigenschaften erstellen, die strikte Gleichheit (===) für Schlüsselvergleiche verwendet. Wenn ein Objekt als Schlüssel verwendet wird, erfolgt die Suche nach dem Objekt mithilfe dessen Identität statt mit dem Wert, der durch den Aufruf von toString() für das Objekt zurückgegeben wird.

Hinweis: Sie können kein QName-Objekt als Dictionary-Schlüssel verwenden.

Die nachstehenden Anweisungen veranschaulichen die Beziehung zwischen einem Dictionary-Objekt und einem Schlüsselobjekt:

 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
 

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
Öffentliche Methoden
 MethodeDefiniert von
  
Dictionary(weakKeys:Boolean = false)
Erstellt ein neues Dictionary-Objekt.
Dictionary
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
Stellt eine überschreibbare Methode zum Anpassen der JSON-Kodierung von Werten in einem Dictionary-Objekt bereit.
Dictionary
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Konstruktordetails

Dictionary

()Konstruktor
public function Dictionary(weakKeys:Boolean = false)

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt ein neues Dictionary-Objekt. Verwenden Sie den delete-Operator, um einen Schlüssel aus einem Dictionary-Objekt zu entfernen.

Parameter
weakKeys:Boolean (default = false) — Weist das Dictionary-Objekt an, für Objektschlüssel „schwache“ Verweise zu verwenden. Wenn sich der einzige Verweis auf ein Objekt in dem angegebenen Dictionary-Objekt befindet, unterliegt der Schlüssel dem Garbagekollektor und wird beim Wiedergewinnen des freigegebenen Objektspeichers aus der Tabelle entfernt. Beachten Sie, dass das Dictionary niemals schwache String-Schlüssel aus der Tabelle entfernt. Speziell im Fall von String-Schlüsseln wird der schwache Verweis niemals aus der Schlüsseltabelle entfernt, und das Dictionary behält einen starken Verweis auf die jeweiligen Werte.
Methodendetails

toJSON

()Methode
public function toJSON(k:String):*

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 11, AIR 3, Flash Lite 4

Stellt eine überschreibbare Methode zum Anpassen der JSON-Kodierung von Werten in einem Dictionary-Objekt bereit.

Die JSON.stringify()-Methode sucht bei jedem Objekt, das untersucht wird, nach einer toJSON()-Methode. Wenn die toJSON()-Methode gefunden wird, ruft JSON.stringify() diese für jeden gefundenen Wert auf und übergibt dabei den Schlüssel, der diesem Wert zugeordnet ist.

Dictionary stellt eine standardmäßige Implementierung von toJSON() bereit, die einfach den Namen der Klasse zurückgibt. Kunden, die Dictionary-Objekte für JSON exportieren möchten, müssen ihre eigene toJSON-Implementierung verwenden. Dazu können Sie die toJSON()-Methode für den Klassenprototyp neu definieren.

Die toJSON()-Methode kann einen Wert eines beliebigen Typs zurückgeben. Wenn sie ein Objekt zurückgibt, führt stringify() eine Rekursion in dieses Objekt aus. Wenn toJSON() einen String zurückgibt, führt stringify() keine Rekursion aus und setzt die Untersuchung fort.

Parameter

k:String — Der Schlüssel eines Schlüssel/Wert-Paares, das JSON.stringify() beim Durchlaufen dieses Objekts gefunden hat

Rückgabewerte
* — Der String mit dem Klassennamen.

Verwandte API-Elemente

Object
Object.prototype




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.