適用於 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

The ChannelFaultEvent class is used to propagate channel fault events within the messaging system.



公用屬性
 屬性定義自
 Inheritedbubbles : Boolean
[唯讀] 指出事件是否為反昇事件。
Event
 Inheritedcancelable : Boolean
[唯讀] 指出是否可避免與事件相關聯的行為指令。
Event
 Inheritedchannel : Channel
The Channel that generated this event.
ChannelEvent
 Inheritedconnected : Boolean
Indicates whether the Channel that generated this event is already connected.
ChannelEvent
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
 InheritedcurrentTarget : Object
[唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。
Event
 InheritedeventPhase : uint
[唯讀] 事件流程中的目前階段。
Event
  faultCode : String
Provides access to the destination-specific failure code.
ChannelFaultEvent
  faultDetail : String
Provides destination-specific details of the failure.
ChannelFaultEvent
  faultString : String
Provides access to the destination-specific reason for the failure.
ChannelFaultEvent
 Inheritedreconnecting : Boolean
Indicates whether the Channel that generated this event is reconnecting.
ChannelEvent
 Inheritedrejected : Boolean
Indicates whether the Channel that generated this event was rejected.
ChannelEvent
  rootCause : Object
Provides access to the underlying reason for the failure if the channel did not raise the failure itself.
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)
Constructs an instance of this event with the specified type.
ChannelFaultEvent
  
[覆寫] Clones the ChannelFaultEvent.
ChannelFaultEvent
  
Creates an ErrorMessage based on the ChannelFaultEvent by copying over the faultCode, faultString, faultDetail and rootCause to the new ErrorMessage.
ChannelFaultEvent
  
createEvent(channel:Channel, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false):ChannelFaultEvent
[靜態] Utility method to create a new ChannelFaultEvent that doesn't bubble and is not cancelable.
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
  
[覆寫] Returns a string representation of the ChannelFaultEvent.
ChannelFaultEvent
 Inherited
會傳回指定之物件的基本值。
Object
公用常數
 常數定義自
  FAULT : String = "channelFault"
[靜態] The FAULT event type; indicates that the Channel faulted.
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

Provides access to the destination-specific failure code. For more specific details see the faultString and faultDetails properties.

The format of the fault codes are provided by the remote destination, but will typically have the following form: host.operation.error or Channel.operation.error. For example, "Server.Connect.Failed" and Channel.Connect.Failed.

Channel.Connect.Failed is issued by the Channel class and its subclasses (RTMPChannel, AMFChannel, HTTPChannel, and so forth) whenever there is an issue in a Channel's connect attempts to the remote destination. Channel.Call.Failed is issued by the AMFChannel when the channel is already connected but it gets a Call.Failed code from its underlying NetConnection. Only the AMFChannel class listens for NetConnection.Call.Failed, which gets converted to 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

Provides destination-specific details of the failure.

Typically fault details are a stack trace of an exception thrown at the remote destination.

相關 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

Provides access to the destination-specific reason for the failure.

相關 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

Provides access to the underlying reason for the failure if the channel did not raise the failure itself.

建構函式詳細資料

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

Constructs an instance of this event with the specified type. Note that the rejected and connected arguments that correspond to properties defined by the super-class ChannelEvent were not originally included in this method signature and have been added at the end of the argument list to preserve backward compatibility even though this signature differs from ChannelEvent's constructor.

參數
type:String — The type of the event.
 
bubbles:Boolean (default = false) — Indicates whether the event can bubble up the display list hierarchy.
 
cancelable:Boolean (default = false) — Indicates whether the behavior associated with the event can be prevented.
 
channel:Channel (default = null) — The Channel generating the event.
 
reconnecting:Boolean (default = false) — Indicates whether the Channel is in the process of reconnecting or not.
 
code:String (default = null) — The fault code.
 
level:String (default = null) — The fault level.
 
description:String (default = null) — The fault description.
 
rejected:Boolean (default = false) — Indicates whether the Channel's connection has been rejected, which suppresses automatic reconnection.
 
connected:Boolean (default = false) — Indicates whether the Channel that generated this event is already connected.
方法詳細資訊

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

Clones the ChannelFaultEvent.

傳回值
Event — Copy of this 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

Creates an ErrorMessage based on the ChannelFaultEvent by copying over the faultCode, faultString, faultDetail and rootCause to the new ErrorMessage.

傳回值
ErrorMessage — The 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

Utility method to create a new ChannelFaultEvent that doesn't bubble and is not cancelable.

參數

channel:Channel — The Channel generating the event.
 
reconnecting:Boolean (default = false) — Indicates whether the Channel is in the process of reconnecting or not.
 
code:String (default = null) — The fault code.
 
level:String (default = null) — The fault level.
 
description:String (default = null) — The fault description.
 
rejected:Boolean (default = false) — Indicates whether the Channel's connection has been rejected, which suppresses automatic reconnection.
 
connected:Boolean (default = false) — Indicates whether the Channel that generated this event is already connected.

傳回值
ChannelFaultEvent — New 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

Returns a string representation of the ChannelFaultEvent.

傳回值
String — String representation of the 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

The FAULT event type; indicates that the Channel faulted.

The value of this constant is "channelFault".

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
channelThe Channel that generated this event.
currentTargetThe Object that defines the event listener that handles the event. For example, if you use myButton.addEventListener() to register an event listener, myButton is the value of the currentTarget.
faultCodeProvides destination-specific details of the failure.
faultDetailProvides access to the destination-specific reason for the failure.
faultStringProvides access to the underlying reason for the failure if the channel did not raise the failure itself.
reconnecting Indicates whether the channel that generated this event is reconnecting.
rootCause Provides access to the underlying reason for the failure if the channel did not raise the failure itself.
targetThe Object that dispatched the event; it is not always the Object listening for the event. Use the currentTarget property to always access the Object listening for the event.





[ X ]為什麼顯示英文?
「ActionScript 3.0 參考」的內容是以英文顯示

並非所有「ActionScript 3.0 參考」的內容都翻譯為所有語言。當語言元素未翻譯時,就會以英文顯示。例如,ga.controls.HelpBox 類別並沒有翻譯為任何語言。因此在參考的繁體中文版本中,ga.controls.HelpBox 類別就會以英文顯示。