MessageFaultEvent

包	mx.messaging.events
类	public class MessageFaultEvent
继承	MessageFaultEvent Event Object

语言版本:

ActionScript 3.0

产品版本:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

运行时版本:

Flash Player 9, AIR 1.1

MessageFaultEvent 类用于在消息传送系统中传送错误消息。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		bubbles : Boolean [只读] 表示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读] 表示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读] 事件流中的当前阶段。	Event
		faultCode : String [只读] 提供对特定于目标的失败代码的访问权限。	MessageFaultEvent
		faultDetail : String [只读] 提供有关此失败特定于目标的详细信息。	MessageFaultEvent
		faultString : String [只读] 提供对此失败特定于目标的原因的访问权限。	MessageFaultEvent
		message : ErrorMessage 此事件的 ErrorMessage。	MessageFaultEvent
		rootCause : Object [只读] 提供对此失败的根本原因的访问权限（如果存在）。	MessageFaultEvent
		target : Object [只读] 事件目标。	Event
		type : String [只读] 事件的类型。	Event

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		MessageFaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, message:ErrorMessage = null) 构造一个错误消息事件的实例，以提供指定消息和错误信息。	MessageFaultEvent
		clone():Event [覆盖] 克隆 MessageFaultEvent。	MessageFaultEvent
		createEvent(msg:ErrorMessage):MessageFaultEvent [静态] 用于创建不起泡且不可取消的新 MessageFaultEvent 的实用程序方法。	MessageFaultEvent
		formatToString(className:String, ... arguments):String 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。	Event
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isDefaultPrevented():Boolean 检查是否已对事件调用 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		preventDefault():void 如果可以取消事件的默认行为，则取消该行为。	Event
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stopImmediatePropagation():void 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。	Event
		stopPropagation():void 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。	Event
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String [覆盖] 返回 MessageFaultEvent 的字符串表示形式。	MessageFaultEvent
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		FAULT : String = "fault" [静态] FAULT 事件类型；当消息发生错误时调度。	MessageFaultEvent

属性详细信息

faultCode

属性

faultCode:String [只读]

语言版本:

ActionScript 3.0

产品版本:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

运行时版本:

Flash Player 9, AIR 1.1

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

远程目标可提供错误代码的格式，但通常为：host.operation.error，例如，"Server.Connect.Failed"

实现
public function get faultCode():String

相关 API 元素

faultString
faultDetail

faultDetail

属性

faultDetail:String [只读]

语言版本:

ActionScript 3.0

产品版本:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

实现
public function get faultDetail():String

相关 API 元素

faultString
faultCode

faultString

属性

faultString:String [只读]

语言版本:

ActionScript 3.0

产品版本:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get faultString():String

相关 API 元素

faultCode
faultDetail

message

属性

public var message:ErrorMessage

语言版本:

ActionScript 3.0

产品版本:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

运行时版本:

Flash Player 9, AIR 1.1

此事件的 ErrorMessage。

rootCause

属性

rootCause:Object [只读]

语言版本:

ActionScript 3.0

产品版本:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

运行时版本:

Flash Player 9, AIR 1.1

提供对此失败的根本原因的访问权限（如果存在）。如果是目标引发的自定义异常，则根本原因不过是由 ErrorMessage 传输引起的顶级失败。

实现
public function get rootCause():Object

相关 API 元素

MessageFaultEvent.rootCause

构造函数详细信息

()

构造函数

public function MessageFaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, message:ErrorMessage = null)

语言版本:

ActionScript 3.0

产品版本:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

运行时版本:

Flash Player 9, AIR 1.1

构造一个错误消息事件的实例，以提供指定消息和错误信息。

参数

	`type:String` — MessageAckEvent 的类型。

	`bubbles:Boolean` (default = `false`) — 指定该事件是否可以在显示列表层次结构得到冒泡处理。

	`cancelable:Boolean` (default = `false`) — 表示是否可以阻止与事件相关联的行为。

	`message:ErrorMessage` (default = `null`) — 与错误相关联的 ErrorMessage。

方法详细信息

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

克隆 MessageFaultEvent。

Event — 此 MessageFaultEvent 的副本。

createEvent

()

方法

public static function createEvent(msg:ErrorMessage):MessageFaultEvent

语言版本:

ActionScript 3.0

产品版本:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

msg:ErrorMessage — 与错误相关联的 ErrorMessage。

MessageFaultEvent — 新 MessageFaultEvent。

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

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

String — MessageFaultEvent 的字符串表示形式。

常量详细信息

FAULT

常量

public static const FAULT:String = "fault"

语言版本:

ActionScript 3.0

产品版本:

BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3

运行时版本:

Flash Player 9, AIR 1.1

FAULT 事件类型；当消息发生错误时调度。

此常量的值为 "fault"。

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

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`faultCode`	提供有关此失败的特定于目标的详细信息。
`faultDetail`	提供对此失败特定于目标的原因的访问权限。
`faultString`	如果通道本身未引发失败，则提供对此失败根本原因的访问权限。
`message`	此事件的 ErrorMessage。
`rootCause`	提供对此失败的根本原因的访问权限（如果存在）。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

法律声明 | 在线隐私策略

MessageFaultEvent - AS3 BlazeDS LCDS

类 x

faultCode

faultDetail

faultString

message

rootCause