ItemReference

套件	mx.data
類別	public dynamic class ItemReference
繼承	ItemReference AsyncToken EventDispatcher Object
實作	IItemReference

語言版本:

ActionScript 3.0

產品版本:

Adobe Digital Enterprise Platform Data Services for Java EE 3

執行階段版本:

Flash Player 9, AIR 1.1

An ItemReference instance is returned from the DataService.getItem() and DataService.createItem() methods to provide a way to manage a reference to the remote object. The AsyncToken implementation that this class extends provides a list of responders to be notified of result and fault events that occur on the operation to retrieve the item (the get or the create). A binding can be made to the value of the result property that always maintains a reference to the managed instance. If the item is deleted in another client, the result property will be set to null. If a fault occurs and the DatService instance cannot retrieve the item, the invalid property is set to true. Listen for the fault event to get more information about what caused the error.

To release the reference to this managed item, call the ItemReference.releaseItem() method. This is similar to calling the DataService.releaseItem() method however, unlike the DataService.releaseItem() this method releases this reference rather than the first item instance found of that type. This occurs when more than one getItem() method call to retrieve the same item from different parts of an application is made.

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		message : IMessage [唯讀] Provides access to the associated message.	AsyncToken
		responders : Array [唯讀] An array of IResponder handlers that will be called when the asynchronous request completes.	AsyncToken
		result : Object [唯讀] The result that was returned by the associated RPC call.	AsyncToken
		valid : Boolean Set to false if the ItemReference becomes invalid either because the server faulted when trying to retrieve the item or if the retrieved item was itself null.	ItemReference

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		ItemReference(msg:IMessage) Constructor.	ItemReference
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		addResponder(responder:IResponder):void Adds a responder to an Array of responders.	AsyncToken
		dispatchEvent(event:Event):Boolean 會將事件傳送到事件流程。	EventDispatcher
		hasEventListener(type:String):Boolean 會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		hasResponder():Boolean Determines if this token has at least one mx.rpc.IResponder registered.	AsyncToken
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		releaseItem(copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):void Releases the managed item reference retrieved with the getItem() or createItem() method call that returned this ItemReference.	ItemReference
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 會從 EventDispatcher 物件移除偵聽程式。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	EventDispatcher

事件

按一下以瞭解事件的詳細資訊

隱藏繼承事件

顯示繼承事件

	摘要	定義自
activate	[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。	EventDispatcher
deactivate	[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。	EventDispatcher
propertyChange	Dispatched when a property of the channel set changes.	AsyncToken

屬性詳細資訊

valid

屬性

valid:Boolean

語言版本:

ActionScript 3.0

產品版本:

Adobe Digital Enterprise Platform Data Services for Java EE 3

執行階段版本:

Flash Player 9, AIR 1.1

Set to false if the ItemReference becomes invalid either because the server faulted when trying to retrieve the item or if the retrieved item was itself null. This property can be used to bind to your user interface controls to display status information for this item without having to listen for explicit fault events.

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 propertyChange 事件。

實作
public function get valid():Boolean
public function set valid(value:Boolean):void

建構函式詳細資料

()

建構函式

public function ItemReference(msg:IMessage)

語言版本:

ActionScript 3.0

產品版本:

Adobe Digital Enterprise Platform Data Services for Java EE 3

執行階段版本:

Flash Player 9, AIR 1.1

Constructor.

參數

msg:IMessage — A message object.

方法詳細資訊

releaseItem

()

方法

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

語言版本:

ActionScript 3.0

產品版本:

Adobe Digital Enterprise Platform Data Services for Java EE 3

執行階段版本:

Flash Player 9, AIR 1.1

Releases the managed item reference retrieved with the getItem() or createItem() method call that returned this ItemReference. It is possible to have more than one ItemReference that points to the same item on the same client. Use this method to release the proper reference.

參數

	`copyStillManagedItems:Boolean` (default = `true`) — Boolean indicating that a copy of this item should be placed in this ItemReference should the current item still be referenced. This can occur if more than one call to `DataService.getItem()` for this same item is made, or if this item is referenced by a collection returned from a call to `DataService.fill()`.

	`enableStillManagedCheck:Boolean` (default = `true`) — Boolean indicating if the item should be checked for additional references.

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

ItemReference - AS3 ADEP Data Services

類別 x

valid

ItemReference

releaseItem