XMLSocket  - AS3

指出此 XMLSocket 物件目前是否已連線。 您也可以透過註冊 connect 事件和 ioError 事件，檢查連線是否成功。

相關 API 元素

指出等待連線的毫秒數。

如果在指定的時間內連線不成功，連線會失敗。預設值為 20,000 (二十秒)。

建立新的 XMLSocket 物件。 如果沒有指定任何參數，就會建立最初中斷連線的通訊端。 如果有指定參數，就會嘗試連線至指定的主機和連接埠。

注意：強烈建議使用「不含參數」的建構函式形式，接著加入任何事件偵聽程式，最後再搭配 host 和 port 參數呼叫 connect 方法。這個序列會保證所有事件偵聽程式都會正常運作。

相關 API 元素

會關閉 XMLSocket 物件所指定的連線。 只有當伺服器關閉連線時，才會傳送 close 事件。當您呼叫 close() 方法時，則不會傳送此事件。

相關 API 元素

會使用指定的 TCP 連接埠，連線到指定的網際網路主機。

如果您將 host 參數指定為 null，聯繫的主機便是呼叫 XMLSocket.connect() 的檔案所在的電腦。例如，若發出呼叫的檔案是從 www.adobe.com 下載，則 host 參數指定為 null 表示您要連線至 www.adobe.com。

如果您希望防止任何檔案使用此方法，可以在包含 SWF 內容的 HTML 頁面中，設定 object 和 embed 標籤的 allowNetworking 參數。

如需詳細資訊，請參閱「Flash Player 開發人員中心」主題：「安全性」。

參數

相關 API 元素

將 object 參數中所指定的 XML 物件或資料轉換成字串，並在後面加上零 (0) 位元組後傳輸到伺服器。 如果 object 是 XML 物件，這個字串就是此 XML 物件的 XML 文字表示。 傳送作業並不是同步的。它雖然會立即傳回，但是可能要稍後才會傳輸資料。 XMLSocket.send() 方法並不會傳回值來表示資料是否已傳輸成功。

如果您並未使用 XMLSocket.connect()，將 XMLSocket 物件連線至伺服器，XMLSocket.send() 作業就會失敗。

參數

相關 API 元素

會在伺服器關閉通訊端連線時傳送。 只有當伺服器關閉連線時，才會傳送 close 事件。當您呼叫 XMLSocket.close() 方法時，則不會傳送此事件。

這個事件具有下列屬性：

會在順利呼叫 XMLSocket.connect() 方法之後傳送。

這個事件具有下列屬性：

在傳送或收到原始資料之後傳送。

這個事件具有下列屬性：

發生輸入/輸出錯誤，因而導致傳送或接收作業失敗時傳送。

這個事件具有下列屬性：

會當 XMLSocket.connect() 方法的呼叫嘗試連線至呼叫者安全執行程序以外的伺服器，或小於 1024 的連接埠時傳送。

這個事件具有下列屬性：

相關 API 元素

1. XMLSocketExample 建構函式會建立 XMLSocket 實體 socket，將 socket 傳遞給 ConfigureListeners() (將在下列範例中說明)，然後使用主機名稱 "localhost" 與 8080 的埠號，呼叫 XMLSocket 的 connect() 方法。
2. 接著呼叫 configureListeners() 方法，將偵聽程式加入每一個支援的 XMLSocket 事件：
   • closeHandler() 會偵聽 close 事件，並在網路連線中斷後將事件送出。
   • connectHandler() 會偵聽 connect 事件，並在建立網路連線後將事件送出。
   • dataHandler() 會偵聽 data 事件，並在每次 XMLSocket 收到新的資料後將事件送出。
   • progressHandler() 會偵聽 progress 事件，並在呼叫 send() 後及傳送作業進行時將事件送出。
   • securityErrorHandler() 會偵聽 securityError 事件，並在嘗試使用錯誤的本機播放安全性設定或小於 1024 的埠號存取 XMLSocket 時將事件送出。
   • ioErrorHandler() 會偵聽 ioError 事件，並只在傳送或接收資料失敗時將事件送出。

注意：

• 在編譯 SWF 檔時，您必須將「本機播放安全性」設定為「只存取網路」。
• 若要讓此範例正確運作，您需要能在網域上使用連接埠 8080 的伺服器。
• 如果您執行 Flash Player 9.0.124.0 或更新版本，則必須在伺服器上放置通訊端原則檔，以允許從您的網域至連接埠 8080 的通訊端連線。如需有關提供通訊端原則檔的詳細資訊，請參閱 Flash Player 開發人員中心主題：「設定通訊端原則檔伺服器」。

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

    public class XMLSocketExample extends Sprite {
        private var hostName:String = "localhost";
        private var port:uint = 8080;
        private var socket:XMLSocket;

        public function XMLSocketExample() {
            socket = new XMLSocket();
            configureListeners(socket);
            if (hostName && port) {
                socket.connect(hostName, port);
            }
        }

        public function send(data:Object):void {
            socket.send(data);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.CLOSE, closeHandler);
            dispatcher.addEventListener(Event.CONNECT, connectHandler);
            dispatcher.addEventListener(DataEvent.DATA, dataHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function closeHandler(event:Event):void {
            trace("closeHandler: " + event);
        }

        private function connectHandler(event:Event):void {
            trace("connectHandler: " + event);
        }

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

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }
    }
}