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

ItemReference 实例从 DataService.getItem() 和 DataService.createItem() 方法返回，以提供一种管理对远程对象的引用的方式。此类扩展的 AsyncToken 实现提供了响应器列表，该列表中的响应器将获得有关检索项的操作（get 或 create）上引发的 result 和 fault 事件的通知。可以对始终保持对托管实例的引用的 result 属性值进行绑定。如果在另一客户端中删除项，result 属性将设置为 null。如果出现错误，并且 DatService 实例无法检索项，则 invalid 属性将设置为 true。侦听 fault 事件以获得有关出错原因的更多信息。

要释放对此托管项的引用，可调用 ItemReference.releaseItem() 方法。虽然这类似于调用 DataService.releaseItem() 方法，但与 DataService.releaseItem() 不同的是，此方法释放此引用，而不是找到的该类型的第一个项实例。如果多次调用 getItem() 方法来从应用程序的不同部分检索同一项，则会出现这种情况。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		message : IMessage [只读] 提供对关联消息的访问。	AsyncToken
		responders : Array [只读] 异步请求完成时将要调用的 IResponder 处理程序数组。	AsyncToken
		result : Object [只读] 关联的 RPC 调用返回的结果。	AsyncToken
		valid : Boolean 如果由于服务器尝试检索项时出错或检索的项本身为 null 而导致 ItemReference 失效，则设置为 false。	ItemReference

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		ItemReference(msg:IMessage) 构造函数。	ItemReference
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		addResponder(responder:IResponder):void 可向响应器 Array 中添加响应器。	AsyncToken
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		hasResponder():Boolean 确定此标记是否至少具有一个注册的 mx.rpc.IResponder。	AsyncToken
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		releaseItem(copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):void 释放通过调用返回此 ItemReference 的 getItem() 或 createItem() 方法检索到的托管项引用。	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	当通道设置的属性发生更改时调度。	AsyncToken

属性详细信息

valid

属性

valid:Boolean

语言版本:

ActionScript 3.0

产品版本:

Adobe Digital Enterprise Platform Data Services for Java EE 3

运行时版本:

Flash Player 9, AIR 1.1

如果由于服务器尝试检索项时出错或检索的项本身为 null 而导致 ItemReference 失效，则设置为 false。此属性可用于绑定到用户界面控件，以便无需侦听显式错误事件即可显示此项的状态信息。

此属性可用作数据绑定的源。修改此属性后，将调度 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

构造函数。

参数

msg:IMessage — 消息对象。

方法详细信息

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

释放通过调用返回此 ItemReference 的 getItem() 或 createItem() 方法检索到的托管项引用。有可能存在多个指向同一客户端上同一项的 ItemReference。使用此方法释放适当的引用。

参数

	`copyStillManagedItems:Boolean` (default = `true`) — 指示如果仍然引用当前项，应该将此项的副本放置到此 ItemReference 中的布尔值。如果对同一项多次调用 `DataService.getItem()`，或者调用 `DataService.fill()` 后返回的集合引用此项，可能会出现这种情况。

	`enableStillManagedCheck:Boolean` (default = `true`) — 指示是否应该对项检查是否存在其它引用的布尔值。

法律声明 | 在线隐私策略

ItemReference - AS3 ADEP Data Services

类 x

valid

ItemReference

releaseItem