用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
mx.data 

ItemReference  - AS3 ADEP Data Services

mx.data
public dynamic class ItemReference
继承ItemReference Inheritance AsyncToken Inheritance EventDispatcher Inheritance 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() 方法来从应用程序的不同部分检索同一项,则会出现这种情况。



公共属性
 属性由以下参数定义
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheritedmessage : IMessage
[只读] 提供对关联消息的访问。
AsyncToken
 Inheritedresponders : Array
[只读] 异步请求完成时将要调用的 IResponder 处理程序数组。
AsyncToken
 Inheritedresult : Object
[只读] 关联的 RPC 调用返回的结果。
AsyncToken
  valid : Boolean
如果由于服务器尝试检索项时出错或检索的项本身为 null 而导致 ItemReference 失效,则设置为 false。
ItemReference
公共方法
 方法由以下参数定义
  
构造函数。
ItemReference
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
可向响应器 Array 中添加响应器。
AsyncToken
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
确定此标记是否至少具有一个注册的 mx.rpc.IResponder。
AsyncToken
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
  
releaseItem(copyStillManagedItems:Boolean = true, enableStillManagedCheck:Boolean = true):void
释放通过调用返回此 ItemReference 的 getItem() 或 createItem() 方法检索到的托管项引用。
ItemReference
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 由以下参数定义
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
 Inherited当通道设置的属性发生更改时调度。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
构造函数详细信息

ItemReference

()构造函数
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) — 指示是否应该对项检查是否存在其它引用的布尔值。





[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。