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...
mx.data.messages 

UpdateCollectionMessage  - AS3 ADEP Data Services

Paketmx.data.messages
Klassepublic class UpdateCollectionMessage
VererbungUpdateCollectionMessage Inheritance DataMessage Inheritance AsyncMessage Inheritance AbstractMessage Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Mithilfe dieser Meldung wird die Konsistenz zwischen dem Remote-Ziel und der entsprechenden lokalen Sammlung hergestellt. Sie enthält alle Einfüge- und Löschvorgänge, die in einer Sammlung ausgeführt wurden. Clients senden diese Meldung, wenn eine lokale Sammlung mithilfe der Sammlungs-API (IListView.removeItemAt() usw.) oder der Single Managed Object-API (DataService.createItem()) aktualisiert wird. Das Remote-Ziel sendet diese Meldung, wenn die Remote-Sequenz aktualisiert wird und Elemente verschoben oder entfernt und eingefügt werden. Diese body-Eigenschaft enthält eine Liste von UpdateCollectionRange-Objekten, die anzeigen, inwiefern die Sammlung modifiziert wurde. Durch Anwenden der Sammlungsbereiche für die Aktualisierung in der gegebenen Reihenfolge wird eine einheitliche Reihenfolge der Elemente in der angegebene Sammlung hergestellt.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbody : Object
Der Körper einer Meldung enthält die spezifischen Daten, die an das Remote-Ziel zugestellt werden sollen.
AbstractMessage
 InheritedclientId : String
ClientId weist darauf hin, von welchem MessageAgent die Meldung gesendet wurde.
AbstractMessage
  collectionId : Object
Der eindeutige Bezeichner für die Sammlung, die aktualisiert wurde.
UpdateCollectionMessage
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcorrelationId : String
Stellt Zugriff auf die Korrelations-ID der Meldung zur Verfügung.
AsyncMessage
 Inheriteddestination : String
Das Meldungsziel.
AbstractMessage
 Inheritedheaders : Object
Die Header einer Meldung sind ein assoziatives Array, wobei der Schlüssel der Header-Name und der Wert der Header-Wert ist.
AbstractMessage
 Inheritedidentity : Object
Stellt einen Zugriff auf die Identitätsmatrix bereit, die die eindeutige Identität des Elements definiert, auf das sich diese DataMessage auswirkt (relevant für Erstell-/Aktualisier-/Löschvorgänge, aber nicht für Füllvorgänge).
DataMessage
 InheritedmessageId : String
Die eindeutige ID für die Meldung.
AbstractMessage
 Inheritedoperation : uint
Stellt einen Zugriff auf den Vorgangs/Befehl dieser DataMessage bereit.
DataMessage
  replace : Boolean
Zeigt an, ob die gesamte Sammlung durch den Inhalt dieser Meldung ersetzt werden muss.
UpdateCollectionMessage
 Inheritedtimestamp : Number
Stellt Zugriff auf den Zeitstempel für die Meldung zur Verfügung.
AbstractMessage
 InheritedtimeToLive : Number
Die Zeit des Live-Werts einer Meldung gibt an, wie lange die Meldung als gültig und zustellbar betrachtet werden soll.
AbstractMessage
  updateMode : int
Zeigt den Status dieser Aktualisierung an.
UpdateCollectionMessage
Öffentliche Methoden
 MethodeDefiniert von
  
Erstellt eine neue Instanz einer leeren UpdateCollectionMessage.
UpdateCollectionMessage
 Inherited
[statisch] Stellt eine Beschreibung des angegebenen Vorgangs zur Verfügung.
DataMessage
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Wenn dies ein Erstellungsvorgang ist, wird „true“ zurückgegeben.
DataMessage
 Inherited
Wenn diese Meldung eine Aktualisierung ist und die Liste der Eigenschaftsnamen eine Länge von null hat, wird „true“ zurückgegeben.
DataMessage
 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 eine Stringdarstellung der Meldung zurück.
AbstractMessage
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  CLIENT_UPDATE : int = 0
[statisch] Zeigt an, dass diese Meldung zur Aktualisierung der Sammlung vom Client generiert wurde.
UpdateCollectionMessage
  SERVER_OVERRIDE : int = 2
[statisch] Zeigt an, dass diese Meldung zur Aktualisierung der Sammlung vom Client generiert wurde und dass das Remote-Ziel bestimmt hat, dass sie auf diesem Client wiederhergestellt werden soll.
UpdateCollectionMessage
  SERVER_UPDATE : int = 1
[statisch] Zeigt an, dass diese Meldung zur Aktualisierung der Sammlung remote generiert wurde und auf dem aktuellen Status der Remote-Sequenz basiert.
UpdateCollectionMessage
Eigenschaftendetails

collectionId

Eigenschaft
public var collectionId:Object

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Der eindeutige Bezeichner für die Sammlung, die aktualisiert wurde. Für eine Sammlung, die mit der DataService.fill()-Methode gefüllt wurde und ein Array an festgelegten Parametern enthält.

replace

Eigenschaft 
public var replace:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, ob die gesamte Sammlung durch den Inhalt dieser Meldung ersetzt werden muss. Wenn die Anzahl der Änderungen an einer Remote-Sequenz einen Umkipp-Punkt erreicht, wird zur Optimierung eine Meldung zum Ersetzen generiert. Ist der Wert true, enthält die body-Eigenschaft ein Array an Objektidentitäten, die vorhandene Objekte ersetzen sollen.

updateMode

Eigenschaft 
public var updateMode:int

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt den Status dieser Aktualisierung an. Das Remote-Ziel sendet Meldungen zur Aktualisierung der Sammlung an Clients mit einem von drei Aktualisierungsmodi:

  • UpdateCollectionMessage.SERVER_UPDATE - der Client wendet diese Aktualisierung der Sammlung bedingungslos an.
  • UpdateCollectionMessage.CLIENT_UPDATE - der übergebende Client muss die Aktualisierung der Sammlung nicht verarbeiten.
  • UpdateCollectionMessage.SERVER_OVERRIDEN - das Remote-Ziel ändert die Meldung der Aktualisierung der Sammlung, die vom Client gesendet wurde und der übergebende Client muss die Aktualisierung der Sammlung wiederherstellen.

Konstruktordetails

UpdateCollectionMessage

()Konstruktor
public function UpdateCollectionMessage()

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Erstellt eine neue Instanz einer leeren UpdateCollectionMessage.

Konstantendetails

CLIENT_UPDATE

Konstante
public static const CLIENT_UPDATE:int = 0

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, dass diese Meldung zur Aktualisierung der Sammlung vom Client generiert wurde.

Verwandte API-Elemente

SERVER_OVERRIDE

Konstante 
public static const SERVER_OVERRIDE:int = 2

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, dass diese Meldung zur Aktualisierung der Sammlung vom Client generiert wurde und dass das Remote-Ziel bestimmt hat, dass sie auf diesem Client wiederhergestellt werden soll. Eine nachfolgende Meldung zur Aktualisierung der Sammlung folgt, die die korrekten Werte zum Zurücksetzen der Client-Sammlung auf einen mit der Remote-Sammlung konsistenten Status enthält.

Verwandte API-Elemente

SERVER_UPDATE

Konstante 
public static const SERVER_UPDATE:int = 1

Sprachversion: ActionScript 3.0
Produktversion: Adobe Digital Enterprise Platform Data Services für Java EE 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Zeigt an, dass diese Meldung zur Aktualisierung der Sammlung remote generiert wurde und auf dem aktuellen Status der Remote-Sequenz basiert.

Verwandte API-Elemente





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