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 

ItemReference  - AS3 ADEP Data Services

Paketmx.data
Klassepublic dynamic class ItemReference
VererbungItemReference Inheritance AsyncToken Inheritance EventDispatcher Inheritance Object
Implementiert IItemReference

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

Eine ItemReference-Instanz wird von den DataService.getItem()- und DataService.createItem()-Methoden zurückgegeben und bietet die Möglichkeit, einen Verweis auf das Remote-Objekt zu verwalten. Die AsyncToken-Implementierung, die diese Klasse erweitert, stellt eine Liste mit Respondern für Benachrichtigungen zu Ergebnis- und Fehlerereignissen bereit, die beim Abrufen des Elements (durch „get“ oder „create“) eintreten. Eine Bindung kann für den Wert der result-Eigenschaft erstellt werden, die immer einen Verweis auf die verwaltete Instanz enthält. Wird das Element in einem anderen Client gelöscht, wird für die result-Eigenschaft der Wert null festgelegt. Wenn ein Fehler auftritt und die DataService-Instanz das Element nicht abrufen kann, wird die invalid-Eigenschaft als true festgelegt. Warten Sie auf das Fehlerereignis, um weitere Informationen über die Ursache des Fehlers zu erhalten.

Zum Freigeben des Verweises auf dieses verwaltete Element rufen Sie die ItemReference.releaseItem()-Methode auf. Dies ist vergleichbar mit dem Aufrufen der DataService.releaseItem()-Methode, wobei diese Methode im Gegensatz zu DataService.releaseItem() nicht die erste gefundene Elementinstanz dieses Typs, sondern den Verweis freigibt. Dies tritt auf, wenn mehr als ein Aufruf der getItem()-Methode zum Abrufen desselben Elements von verschiedenen Teilen einer Anwendung durchgeführt wird.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 Inheritedmessage : IMessage
[schreibgeschützt] Gibt Zugriff auf die verknüpfte Meldung.
AsyncToken
 Inheritedresponders : Array
[schreibgeschützt] Ein Array von Ereignisprozeduren, die bei Abschluss der asynchronen Anforderung aufgerufen werden.
AsyncToken
 Inheritedresult : Object
[schreibgeschützt] Das Ergebnis, das vom verknüpften RPC-Aufruf zurückgegeben wurde.
AsyncToken
  valid : Boolean
„False“, wenn die ItemReference ungültig wird, da entweder auf dem Server beim Abrufen des Elements ein Fehler aufgetreten ist oder das Element selbst „null“ ist.
ItemReference
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
ItemReference
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
 Inherited
Fügt einem Array von Respondern einen Responder hinzu.
AsyncToken
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Bestimmt, ob mindestens ein mx.rpc.IResponder des Tokens registriert ist.
AsyncToken
 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
  
releaseItem(copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):void
Gibt den verwalteten Elementverweis frei, der mit dem Aufruf der getItem()- oder createItem()-Methode, die diese ItemReference zurückgegeben hat, abgerufen wurde.
ItemReference
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 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
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 InheritedWird ausgelöst, wenn eine Eigenschaft der Kanalgruppe geändert wird.AsyncToken
Eigenschaftendetails

valid

Eigenschaft
valid:Boolean

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

False, wenn die ItemReference ungültig wird, da entweder auf dem Server beim Abrufen des Elements ein Fehler aufgetreten ist oder das Element selbst „null“ ist. Diese Eigenschaft kann zur Bindung der Schnittstellensteuerelemente an Anzeigestatusinformationen für dieses Element verwendet werden, wobei nicht auf explizite Fehlerereignisse gewartet werden muss.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get valid():Boolean
    public function set valid(value:Boolean):void
Konstruktordetails

ItemReference

()Konstruktor
public function ItemReference(msg:IMessage)

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

Konstruktor.

Parameter
msg:IMessage — Ein Meldungsobjekt.
Methodendetails

releaseItem

()Methode
public function releaseItem(copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):void

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

Gibt den verwalteten Elementverweis frei, der durch den Aufruf der getItem()- oder createItem()-Methode, der diese ItemReference zurückgegeben hat, abgerufen wurde. Es ist möglich, dass mehr als eine ItemReference auf das gleiche Element des gleichen Clients verweisen. Verwenden Sie diese Methode zum Freigeben des richtigen Verweises.

Parameter

copyStillManagedItems:Boolean (default = true) — Boolescher Wert, der anzeigt, dass eine Kopie dieses Elements in die ItemReference platziert werden sollte, falls weiterhin auf das aktuelle Element verwiesen werden sollte. Dies kann auftreten, wenn DataService.getItem mehr als einmal für dasselbe Element aufgerufen wird oder wenn von einer Sammlung, die bei einem DataService.fill()-Aufruf zurückgegeben wurde, auf das Element verwiesen wird.
 
enableStillManagedCheck:Boolean (default = true) — Ein boolescher Wert, der angibt, ob das Element auf zusätzliche Verweise überprüft werden soll.





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