この XMLSocket オブジェクトが現在、接続されているかどうかを示します。connect イベントと ioError イベントに対して登録を行い、接続が成功したかどうかを調べることもできます。

関連項目

新しい XMLSocket オブジェクトを作成します。初期状態では、XMLSocket オブジェクトはサーバーに接続されません。オブジェクトをサーバーに接続するには、XMLSocket.connect() メソッドを呼び出す必要があります。

関連項目

XMLSocket オブジェクトで指定された接続を閉じます。close イベントは、サーバーにより接続が閉じられたときのみ送出されます。close() メソッドを呼び出しても送出されません。

関連項目

指定された TCP ポートを使用して指定されたインターネットホストへの接続を確立します。デフォルトでは、ポリシーファイルを使用していない限り、番号が 1024 以上のポートにのみ接続できます。

XMLSocket.connected プロパティが true の場合、接続プロセスの初期段階は成功しています。XMLSocket.connected プロパティが false の場合、接続に失敗しています。

host パラメータに対して null を指定した場合は、XMLSocket.connect() を呼び出す SWF ファイルが存在するホストに接続します。たとえば、www.adobe.com から SWF ファイルをダウンロードし、host パラメータに null を指定した場合は、www.adobe.com の IP アドレスを入力した場合と同じ結果となります。

関連項目

object パラメータで指定された XML オブジェクトまたはデータをストリングに変換し、その後ろにゼロ (0) バイトを付加してサーバーに転送します。object が XML オブジェクトである場合、ストリングは XML オブジェクトの XML テキスト表現です。送信操作は非同期です。つまり、転送処理はただちに終了しますが、データが転送されるのは、その後です。XMLSocket.send() メソッドは、データが正常に転送されたかどうかを示す値を返しません。

XMLSocket.connect() を使用して、XMLSocket オブジェクトをサーバーに接続していない場合、XMLSocket.send() 操作は失敗します。

関連項目

サーバーによりソケット接続が閉じられたときに送出されます。close イベントは、サーバーにより接続が閉じられたときのみ送出されます。XMLSocket.close() メソッドを呼び出しても送出されません。

close イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

XMLSocket.connect() メソッドの呼び出しが成功した後に送出されます。

connect イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

未処理のデータが送受信された後に送出されます。

data イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

入出力エラーが発生して送信または受信操作が失敗したときに送出されます。

ioError イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

XMLSocket.connect() メソッドの呼び出しによって、呼び出し元のセキュリティサンドボックスの外にあるサーバーや 1024 未満のポート番号に対して接続しようとしたときに送出されます。

SecurityErrorEvent.SECURITY_ERROR 定数は、securityError イベントオブジェクトの type プロパティ値を定義します。

このイベントには、次のプロパティがあります。

関連項目

1. XMLSocketExample コンストラクタは socket という XMLSocket インスタンスを作成し、 次に示す ConfigureListeners() に socket を渡し、 XMLSocket の connect() メソッドを、ホスト名 "localhost" とポート 番号 8080.
を使用して呼び出します。
2. 次に、configureListeners() メソッドを呼び出して、 サポートされる各 XMLSocket イベントにリスナーを追加します。
• closeHandler() は close イベントをリッスンします。このイベントは ネットワーク接続が閉じられた後に送出されます。
• connectHandler() は connect イベントをリッスンします。このイベントは ネットワーク接続が確立されたときに送出されます。
• dataHandler() は data イベントをリッスンします。このイベントは XMLSocket が新しいデータを受け取るたびに送出されます。
• progressHandler() は progress イベントをリッスンします。このイベントは send() が呼び出されたとき、送信中に送出されます。
• securityErrorHandler() は securityError イベントをリッスンします。このイベントは 誤ったローカルでの再生に関するセキュリティ設定または 1024 より小さいポートを使用して、XMLSocket にアクセスしようとしたときに 送出されます。
• ioErrorHandler() は ioError イベントをリッスンします。このイベントは データの送信または受信操作に失敗すると発生します。

メモ :

• [ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要があります。
• このコード例が動作するには、ポート 8080 を使用して、[ドメイン名] 上で実行しているサーバーが必要です。

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);
            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);
        }
    }
}