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

ChannelFaultEvent  - AS3 BlazeDS LCDS

mx.messaging.events
public class ChannelFaultEvent
继承ChannelFaultEvent Inheritance ChannelEvent Inheritance Event Inheritance Object

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

ChannelFaultEvent 类用于在消息传送系统中传送通道错误事件。



公共属性
 属性由以下参数定义
 Inheritedbubbles : Boolean
[只读] 表示事件是否为冒泡事件。
Event
 Inheritedcancelable : Boolean
[只读] 表示是否可以阻止与事件相关联的行为。
Event
 Inheritedchannel : Channel
生成此事件的 Channel。
ChannelEvent
 Inheritedconnected : Boolean
指示是否已与生成此事件的 Channel 建立连接。
ChannelEvent
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcurrentTarget : Object
[只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。
Event
 InheritedeventPhase : uint
[只读] 事件流中的当前阶段。
Event
  faultCode : String
提供对特定于目标的失败代码的访问权限。
ChannelFaultEvent
  faultDetail : String
提供有关此失败的特定于目标的详细信息。
ChannelFaultEvent
  faultString : String
提供对此失败特定于目标的原因的访问权限。
ChannelFaultEvent
 Inheritedreconnecting : Boolean
指示是否正在重新连接生成此事件的通道。
ChannelEvent
 Inheritedrejected : Boolean
指示是否已拒绝生成此事件的通道。
ChannelEvent
  rootCause : Object
如果通道本身未引发失败,则提供对此失败根本原因的访问权限。
ChannelFaultEvent
 Inheritedtarget : Object
[只读] 事件目标。
Event
 Inheritedtype : String
[只读] 事件的类型。
Event
公共方法
 方法由以下参数定义
  
ChannelFaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, channel:Channel = null, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false)
构造具有指定的类型的此事件的一个实例。
ChannelFaultEvent
  
[覆盖] 克隆 ChannelFaultEvent。
ChannelFaultEvent
  
基于 ChannelFaultEvent,通过将 faultCode、faultString、faultDetail 和 rootCause 复制到新的 ErrorMessage 中来创建 ErrorMessage。
ChannelFaultEvent
  
createEvent(channel:Channel, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false):ChannelFaultEvent
[静态] 用于创建不起泡且不可取消的新 ChannelFaultEvent 的实用程序方法。
ChannelFaultEvent
 Inherited
formatToString(className:String, ... arguments):String
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。
Event
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
检查是否已对事件调用 preventDefault() 方法。
Event
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
如果可以取消事件的默认行为,则取消该行为。
Event
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。
Event
 Inherited
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。
Event
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
  
[覆盖] 返回 ChannelFaultEvent 的字符串表示形式。
ChannelFaultEvent
 Inherited
返回指定对象的原始值。
Object
公共常量
 常量由以下参数定义
  FAULT : String = "channelFault"
[静态] FAULT 事件类型;指示发生错误的 Channel。
ChannelFaultEvent
属性详细信息

faultCode

属性
public var faultCode:String

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

提供对特定于目标的失败代码的访问权限。有关更具体的详细信息,请参阅 faultStringfaultDetails 属性。

错误代码的格式由远程目标提供,但通常为:host.operation.errorChannel.operation.error。例如,"Server.Connect.Failed"Channel.Connect.Failed

无论何时 Channel 试图连接到远程目标出现问题,Channel 类及其子类(RTMPChannel、AMFChannel、HTTPChannel 等等)都会发出 Channel.Connect.Failed。通道已连接并且从其基础 NetConnection 获取 Call.Failed 代码之后,AMFChannel 就会发出 Channel.Call.Failed。仅 AMFChannel 类侦听 NetConnection.Call.Failed,后者会被转换为 Channel.Call.Failed。

相关 API 元素

faultDetail

属性 
public var faultDetail:String

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

提供有关此失败的特定于目标的详细信息。

错误详细信息通常是对远程目标引发的异常的堆栈跟踪。

相关 API 元素

faultString

属性 
public var faultString:String

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

提供对此失败特定于目标的原因的访问权限。

相关 API 元素

rootCause

属性 
public var rootCause:Object

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

如果通道本身未引发失败,则提供对此失败根本原因的访问权限。

构造函数详细信息

ChannelFaultEvent

()构造函数
public function ChannelFaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, channel:Channel = null, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false)

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

构造具有指定的类型的此事件的一个实例。请注意:与超类 ChannelEvent 定义的属性相对应的 rejectedconnected 参数最初并未包含在此方法签名中,但已添加到参数列表的末尾,这样即使此签名与 ChannelEvent 的构造函数不同,也能保持向后兼容性。

参数
type:String — 事件的类型。
 
bubbles:Boolean (default = false) — 指示该事件是否可以在显示列表层次结构得到冒泡处理。
 
cancelable:Boolean (default = false) — 表示是否可以阻止与事件相关联的行为。
 
channel:Channel (default = null) — 生成该事件的 Channel。
 
reconnecting:Boolean (default = false) — 指示是否正在重新连接 Channel。
 
code:String (default = null) — 错误代码。
 
level:String (default = null) — 错误级别。
 
description:String (default = null) — 错误描述。
 
rejected:Boolean (default = false) — 指示是否已拒绝 Channel 连接,此参数禁止自动进行重新连接。
 
connected:Boolean (default = false) — 指示是否已与生成此事件的 Channel 建立连接。
方法详细信息

clone

()方法
override public function clone():Event

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

克隆 ChannelFaultEvent。

返回
Event — 此 ChannelFaultEvent 的副本。

createErrorMessage

()方法 
public function createErrorMessage():ErrorMessage

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

基于 ChannelFaultEvent,通过将 faultCode、faultString、faultDetail 和 rootCause 复制到新的 ErrorMessage 中来创建 ErrorMessage。

返回
ErrorMessage — ErrorMessage。

createEvent

()方法 
public static function createEvent(channel:Channel, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false):ChannelFaultEvent

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

用于创建不起泡且不可取消的新 ChannelFaultEvent 的实用程序方法。

参数

channel:Channel — 生成该事件的 Channel。
 
reconnecting:Boolean (default = false) — 指示是否正在重新连接 Channel。
 
code:String (default = null) — 错误代码。
 
level:String (default = null) — 错误级别。
 
description:String (default = null) — 错误描述。
 
rejected:Boolean (default = false) — 指示是否已拒绝 Channel 连接,此参数禁止自动进行重新连接。
 
connected:Boolean (default = false) — 指示是否已与生成此事件的 Channel 建立连接。

返回
ChannelFaultEvent — 新 ChannelFaultEvent。

toString

()方法 
override public function toString():String

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

返回 ChannelFaultEvent 的字符串表示形式。

返回
String — ChannelFaultEvent 的字符串表示形式。
常量详细信息

FAULT

常量
public static const FAULT:String = "channelFault"

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

FAULT 事件类型;指示发生错误的 Channel。

此常量的值为 "channelFault"

事件对象的属性有下列值:

属性
bubblesfalse
cancelablefalse
channel生成此事件的 Channel。
currentTarget用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
faultCode提供有关此失败的特定于目标的详细信息。
faultDetail提供对此失败特定于目标的原因的访问权限。
faultString如果通道本身未引发失败,则提供对此失败根本原因的访问权限。
reconnecting 指示是否正在重新连接生成此事件的通道。
rootCause 如果通道本身未引发失败,则提供对此失败根本原因的访问权限。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。





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

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