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.net 

ObjectEncoding  - AS3

Paketflash.net
Klassepublic final class ObjectEncoding
VererbungObjectEncoding Inheritance Object

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

Mit der ObjectEncoding-Klasse werden Serialisierungseinstellungen in Klassen definiert, die zur Serialisierung von Objekten dienen (zum Beispiel FileStream, NetStream, NetConnection, SharedObject und ByteArray), um mit früheren Versionen von ActionScript arbeiten zu können.

Mit der Objektkodierung wird die AMF-Version (Action Message Format) der Objekte gesteuert. Flash Player verwendet AMF, um eine effiziente Kommunikation zwischen einer Anwendung und einem Remote-Server zu ermöglichen. AMF kodiert Remote Procedure Calls in kompakte Binärdaten, die über HTTP/HTTPS oder das von Flash Media Server verwendete RTMP/RTMPS-Protokoll übertragen werden können. Objekte und Datenwerte werden in dieses Binärformat serialisiert, das in der Regel kompakter ist als andere Darstellungsformen wie XML.

Adobe AIR und Flash Player 9 unterstützen die Serialisierung in zwei verschiedene Formate: AMF3 und AMF0. Das für ActionScript 3.0 entwickelte Standardformat AMF3 bietet im Vergleich zu dem für ActionScript 1.0 und 2.0 verwendeten Format AMF0 mehrere Vorteile. Die Datenübertragung über das Netzwerk erfolgt mit AMF3 effizienter als mit AMF0. AMF3 unterstützt das Senden von int- und uint-Objekten als Ganzzahlen sowie Datentypen, die nur in ActionScript 3.0 verfügbar sind, wie z. B. ByteArray, XML und IExternalizable. Dieses Format ist nur in ActionScript 3.0 und für Server verfügbar, die die AMF3-Kodierung verwenden, wie Flex 2.

Die Klassen ByteArray, NetConnection, NetStream, SharedObject, Socket und URLStream enthalten die objectEncoding-Eigenschaft, der mit der ObjectEncoding-Klasse eine Konstante zugewiesen wird. Das Verhalten der Eigenschaft objectEncoding hängt davon ab, um welches Objekt es sich handelt. In den Beschreibungen zur Eigenschaft objectEncoding der jeweiligen Klassen wird näher darauf eingegangen.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  dynamicPropertyWriter : IDynamicPropertyWriter
[statisch] Ermöglicht eine bessere Steuerung der Serialisierung der dynamischen Eigenschaften dynamischer Objekte.
ObjectEncoding
Öffentliche Methoden
 MethodeDefiniert von
 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
 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
Öffentliche Konstanten
 KonstanteDefiniert von
  AMF0 : uint = 0
[statisch] Gibt an, dass Objekte mit der AMF-Version für ActionScript 1.0 und 2.0 serialisiert werden.
ObjectEncoding
  AMF3 : uint = 3
[statisch] Gibt an, dass Objekte mit der AMF-Version für ActionScript 3.0 serialisiert werden.
ObjectEncoding
  DEFAULT : uint = 3
[statisch] Gibt das Standardformat (neuestes Format) der aktuellen Laufzeitumgebung an (entweder Flash Player oder AIR).
ObjectEncoding
Eigenschaftendetails

dynamicPropertyWriter

Eigenschaft
dynamicPropertyWriter:IDynamicPropertyWriter

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

Ermöglicht eine bessere Steuerung der Serialisierung der dynamischen Eigenschaften dynamischer Objekte. Wenn diese Eigenschaft den Wert null aufweist (Standardwert), werden dynamische Eigenschaften mit systemeigenem Code serialisiert, der alle dynamischen Eigenschaften schreibt, mit Ausnahme der Eigenschaften, die als Wert eine Funktion aufweisen.

Dieser Wert wird nur für Eigenschaften eines dynamischen Objekts aufgerufen (d. h. ein Objekt, das innerhalb einer dynamischen Klasse deklariert wurden) oder für Objekte die mithilfe des new-Operators deklariert wurden.

Sie können diese Eigenschaft verwenden, um Eigenschaften dynamischer Objekte aus der Serialisierung auszuschließen, um Eigenschaften dynamischer Objekte Werte zuzuweisen und um neue Eigenschaften für dynamische Objekte zu erstellen. Stellen Sie hierzu für die Eigenschaft auf ein Objekt ein, das die Schnittstelle „IDynamicPropertyWriter“ implementiert. Weitere Informationen hierzu finden Sie im Abschnitt zur Schnittstelle „IDynamicPropertyWriter“.



Implementierung
    public static function get dynamicPropertyWriter():IDynamicPropertyWriter
    public static function set dynamicPropertyWriter(value:IDynamicPropertyWriter):void

Verwandte API-Elemente

IDynamicPropertyWriter
Konstantendetails

AMF0

Konstante
public static const AMF0:uint = 0

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

Gibt an, dass Objekte mit der AMF-Version für ActionScript 1.0 und 2.0 serialisiert werden.

AMF3

Konstante 
public static const AMF3:uint = 3

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

Gibt an, dass Objekte mit der AMF-Version für ActionScript 3.0 serialisiert werden.

DEFAULT

Konstante 
public static const DEFAULT:uint = 3

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

Gibt das Standardformat (neuestes Format) der aktuellen Laufzeitumgebung an (entweder Flash Player oder AIR). Da die Steuerung der Objektkodierung nur in Flash Player 9 und neueren Versionen und in Adobe AIR verfügbar ist, können nur Formate ab der AMF-Version für ActionScript 3.0 verwendet werden.

Wenn für ein Objekt die objectEncoding-Eigenschaft auf ObjectEncoding.DEFAULT eingestellt ist, wird die AMF3-Kodierung verwendet. Wenn in Zukunft in einer neueren Version von Flash Player oder Adobe AIR eine neue AMF-Version eingeführt wird und Sie Ihre Inhalte neu veröffentlichen, wird die neue AMF-Version verwendet. Verwenden Sie diese Konstante nur, wenn Sie keinen Wert auf die Interoperabilität mit älteren Versionen legen.





[ 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.