DataEvent

套件	flash.events
類別	public class DataEvent
繼承	DataEvent TextEvent Event Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

當原始資料已載入完成時，物件會傳送 DataEvent 物件。資料事件共分為兩種：

DataEvent.DATA：在資料傳送或接收時傳送。
DataEvent.UPLOAD_COMPLETE_DATA：在資料已傳送且伺服器已回應時傳送。

檢視範例

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		bubbles : Boolean [唯讀] 指出事件是否為反昇事件。	Event
		cancelable : Boolean [唯讀] 指出是否可避免與事件相關聯的行為指令。	Event
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		currentTarget : Object [唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。	Event
		data : String 已載入 Flash Player 或 Adobe AIR 的原始資料。	DataEvent
		eventPhase : uint [唯讀] 事件流程中的目前階段。	Event
		target : Object [唯讀] 事件目標。	Event
		text : String 用於 textInput 事件，代表使用者所輸入的字元或字元序列。	TextEvent
		type : String [唯讀] 事件類型。	Event

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		DataEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, data:String = "") 建立包含資料事件相關資訊的事件物件。	DataEvent
		clone():Event [覆寫] 建立 DataEvent 物件的副本，並將每個屬性的值設為符合原始物件的屬性值。	DataEvent
		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 [覆寫] 傳回包含 DataEvent 物件所有屬性的字串。	DataEvent
		valueOf():Object 會傳回指定之物件的基本值。	Object

公用常數

隱藏繼承公用常數

顯示繼承公用常數

	常數		定義自
		DATA : String = "data" [靜態] 定義 data 事件物件的 type 屬性值。	DataEvent
		UPLOAD_COMPLETE_DATA : String = "uploadCompleteData" [靜態] 定義 uploadCompleteData 事件物件的 type 屬性值。	DataEvent

屬性詳細資訊

data

屬性

data:String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

已載入 Flash Player 或 Adobe AIR 的原始資料。

實作
public function get data():String
public function set data(value:String):void

建構函式詳細資料

()

建構函式

public function DataEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, data:String = "")

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

建立包含資料事件相關資訊的事件物件。 Event 物件會當做參數傳遞至事件偵聽程式。

參數

	`type:String` — 事件類型。事件偵聽程式可以透過繼承的 `type` 屬性來存取此資訊。資料事件只有一種類型：`DataEvent.DATA`。

	`bubbles:Boolean` (default = `false`) — 判斷事件物件是否參與事件流程的反昇階段。事件偵聽程式可以透過繼承的 `bubbles` 屬性來存取此資訊。

	`cancelable:Boolean` (default = `false`) — 判斷是否可以取消 Event 物件。事件偵聽程式可以透過繼承的 `cancelable` 屬性來存取此資訊。

	`data:String` (default = "") — 已載入 Flash Player 或 Adobe AIR 的原始資料。事件偵聽程式可以透過 `data` 屬性來存取此資訊。

相關 API 元素

flash.net.XMLSocket
DataEvent.DATA

方法詳細資訊

clone

()

方法

override public function clone():Event

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

建立 DataEvent 物件的副本，並將每個屬性的值設為符合原始物件的屬性值。

傳回值

Event — 新的 DataEvent 物件，其屬性值符合原始物件的屬性值。

toString

()

方法

override public function toString():String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

傳回包含 DataEvent 物件所有屬性的字串。此字串的格式如下：

[DataEvent type=value bubbles=value cancelable=value data=value]

傳回值

String — 包含 DataEvent 物件所有屬性的字串。

常數詳細資訊

DATA

常數

public static const DATA:String = "data"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

定義 type 屬性值 (data 事件物件)。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`data`	已載入 Flash Player 或 Adobe AIR 的原始資料。
`target`	接收資料的 XMLSocket 物件。

相關 API 元素

flash.net.XMLSocket.data

UPLOAD_COMPLETE_DATA

常數

public static const UPLOAD_COMPLETE_DATA:String = "uploadCompleteData"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4

定義的 type 屬性值 (uploadCompleteData 事件物件)。

這個事件具有下列屬性：

屬性	值
`bubbles`	`false`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`data`	成功上載檔案以後，從伺服器傳回的原始資料。
`target`	成功上載以後，接收資料的 FileReference 物件。

範例如何使用本範例

DataEventExample.as

下列範例會建立 XMLSocket，並將它連接到 yourDomain 網域的通訊端伺服器(連接埠為 8080)。事件偵聽程式會附加在偵聽 data 事件的 XMLSocket 物件上，該事件會在每次接收到原始資料時傳送。

注意：

若要產生 securityError 事件，您必須在編譯 SWF 檔時，將「本機播放安全性」設定為「只存取網路」。
您需要一個使用埠號 8080，並在 [ yourDomain ] 上執行的伺服器。

package {
    import flash.display.Sprite;
    import flash.events.DataEvent;
    import flash.net.XMLSocket;

    public class DataEventExample extends Sprite {
        private var hostName:String = "[yourDomain]";
        private var port:uint = 8080;
        private var socket:XMLSocket;

        public function DataEventExample() {
            socket = new XMLSocket();
            socket.addEventListener(DataEvent.DATA, dataHandler);
            socket.connect(hostName, port);
        }

        private function dataHandler(event:DataEvent):void {
            trace("dataHandler: " + event.data);
        }
    }
}

法律聲明 | 線上隱私權政策

DataEvent - AS3

類別 x

data

DataEvent

clone

toString

DATA

UPLOAD_COMPLETE_DATA