FaultEvent

包	mx.rpc.events
类	public class FaultEvent
继承	FaultEvent AbstractEvent MessageEvent Event Object
子类	ColdFusionServiceFaultEvent, DataServiceFaultEvent, SyncFaultEvent

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

RPC 调用产生错误时调度此事件。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		bubbles : Boolean [只读] 表示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读] 表示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读] 事件流中的当前阶段。	Event
		fault : Fault [只读] 包含导致此事件原因的详细信息的 Fault 对象。	FaultEvent
		headers : Object 在某些情况下，标头也可能与错误一起返回以提供失败的更多上下文。	FaultEvent
		message : IMessage 与此事件相关联的 Message。	MessageEvent
		statusCode : int [只读] 如果通过 HTTP 发送源消息，则此属性提供对 HTTP 响应状态代码（如果可用）的访问，否则值为 0。	FaultEvent
		target : Object [只读] 事件目标。	Event
		token : mx.rpc:AsyncToken [只读] 表示方法调用的标记。	AbstractEvent
		type : String [只读] 事件的类型。	Event

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		FaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, fault:Fault = null, token:mx.rpc:AsyncToken = null, message:IMessage = null) 创建一个新的 FaultEvent。	FaultEvent
		clone():Event [覆盖] 克隆 MessageEvent。	MessageEvent
		createEvent(fault:Fault, token:mx.rpc:AsyncToken = null, msg:IMessage = null):FaultEvent [静态] 如果给定一个 Fault，则此方法构造并返回一个 FaultEvent。	FaultEvent
		createEventFromMessageFault(value:MessageFaultEvent, token:mx.rpc:AsyncToken = null):FaultEvent [静态] 如果给定一个 MessageFaultEvent，则此方法构造并返回一个 FaultEvent。	FaultEvent
		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 [覆盖] 返回 FaultEvent 的字符串表示形式。	FaultEvent
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		FAULT : String = "fault" [静态] FAULT 事件类型。	FaultEvent

属性详细信息

fault

属性

fault:Fault [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

包含导致此事件原因的详细信息的 Fault 对象。

实现
public function get fault():Fault

headers

属性

headers:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在某些情况下，标头也可能与错误一起返回以提供失败的更多上下文。

实现
public function get headers():Object
public function set headers(value:Object):void

statusCode

属性

statusCode:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果通过 HTTP 发送源消息，则此属性提供对 HTTP 响应状态代码（如果可用）的访问，否则值为 0。

实现
public function get statusCode():int

构造函数详细信息

()

构造函数

public function FaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, fault:Fault = null, token:mx.rpc:AsyncToken = null, message:IMessage = null)

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

创建一个新的 FaultEvent。fault 是必选参数，call 和 message 是可选参数。

参数

	`type:String` — 事件类型；指示触发事件的动作。

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

	`cancelable:Boolean` (default = `true`) — 指定是否可以防止与事件相关联的行为。

	`fault:Fault` (default = `null`) — 保存错误详细信息（包括 faultCode 和 faultString）的对象。

	`token:mx.rpc:AsyncToken` (default = `null`) — 表示方法调用的标记。用于异步完成标记模式。

	`message:IMessage` (default = `null`) — 错误的源 Message。

方法详细信息

createEvent

()

方法

public static function createEvent(fault:Fault, token:mx.rpc:AsyncToken = null, msg:IMessage = null):FaultEvent

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果给定一个 Fault，则此方法构造并返回一个 FaultEvent。

参数

	`fault:Fault` — 包含 FaultEvent 详细信息的错误。

	`token:mx.rpc:AsyncToken` (default = `null`) — 与此错误关联的 AsyncToken [可选]。

	`msg:IMessage` (default = `null`) — 与此错误关联的 Message [可选]。

FaultEvent — 返回一个 FaultEvent。

createEventFromMessageFault

()

方法

public static function createEventFromMessageFault(value:MessageFaultEvent, token:mx.rpc:AsyncToken = null):FaultEvent

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果给定一个 MessageFaultEvent，则此方法构造并返回一个 FaultEvent。

参数

	`value:MessageFaultEvent` — 从中提取相应错误信息的 MessageFaultEvent 引用。

	`token:mx.rpc:AsyncToken` (default = `null`) — 与此错误关联的 AsyncToken [可选]。

FaultEvent — 返回一个 FaultEvent。

toString

()

方法

override public function toString():String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

常量详细信息

FAULT

常量

public static const FAULT:String = "fault"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

FAULT 事件类型。

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

属性	值
`bubbles`	false
`cancelable`	true，通过关联标记的 responder.fault 方法调用 preventDefault() 将防止服务或操作调度此事件。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`fault`	包含导致此事件原因的详细信息的 Fault 对象。
`message`	与此事件相关联的 Message。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`token`	表示方法调用的标记。用于异步完成标记模式。

法律声明 | 在线隐私策略

FaultEvent - AS3 Flex

类 x

fault

headers

statusCode

FaultEvent

createEvent

createEventFromMessageFault

toString

FAULT