指示此 XMLSocket 对象目前是否已连接。 还可以通过为 connect 事件和 ioError 事件注册来检查连接是否成功。

另请参见

创建一个新的 XMLSocket 对象。 XMLSocket 对象开始时不与任何服务器连接。 必须调用 XMLSocket.connect() 方法将该对象连接到服务器。

另请参见

关闭由 XMLSocket 对象指定的连接。 仅在服务器关闭连接时调度 close 事件；在调用 close() 方法时不调度该事件。

另请参见

使用指定的 TCP 端口建立到指定 Internet 主机的连接。 除非使用策略文件，否则在默认情况下只能连接到端口 1024 或更高端口。

如果为 host 参数指定 null，则与调用 XMLSocket.connect() 的 SWF 文件所在的主机连接。 例如，如果 SWF 文件是从 www.adobe.com 下载的，则将 host 参数指定为 null 与输入 www.adobe.com 的 IP 地址效果相同。

如果 SWF 文件运行于 Flash Player 7 以前版本的播放器中，则 host 必须与发出此调用的 SWF 文件位于同一个超级域中。 例如，在位于 www.adobe.com 的 SWF 文件与位于 store.adobe.com 的 SWF 文件之间可以发送或接收变量，因为这两个文件都在同一个名为 adobe.com 的超级域中。

如果任何版本的 SWF 文件运行于 Flash Player 7 或更高版本中，则 host 必须位于完全相同的域中。 例如，位于 www.adobe.com 上的为 Flash Player 5 发布但运行于 Flash Player 7 或更高版本中的 SWF 文件只能向同样位于 www.adobe.com 的 SWF 文件发送（或从中接受）变量。 如果要向其它域发送或从中接收变量，可以在承载被访问的 SWF 文件的服务器上放置一个跨域策略文件。

可以在包含 SWF 内容的 HTML 页中设置 object 和 embed 标签的 allowNetworking 参数，防止 SWF 文件使用此方法。

有关详细信息，请参阅以下部分：

• security chapter（在《ActionScript 3.0 编程》一书中）和有关 LiveDocs 的最新注释
• Flash Player 9 Security White Paper

参数

另请参见

将 object 参数中指定的 XML 对象或数据转换成字符串，并将其传输到服务器，后面跟有一个零 (0) 字节。 如果 object 是一个 XML 对象，则该字符串是此 XML 对象的 XML 文本表示形式。 发送操作是异步的；它将立即返回，但数据可能会以后传输。 XMLSocket.send() 方法不返回指示数据是否成功传输的值。

如果不是使用 XMLSocket.connect() 将 XMLSocket 对象连接到服务器，则 XMLSocket.send() 操作失败。

参数

另请参见

在服务器关闭套接字连接时调度。 仅在服务器关闭连接时调度 close 事件；在调用 XMLSocket.close() 方法时不调度该事件。

此事件具有以下属性：

在成功调用 XMLSocket.connect() 方法后调度。

此事件具有以下属性：

在发送或接收原始数据后调度。

此事件具有以下属性：

在出现输入/输出错误并导致发送或接收操作失败时调度。

此事件具有以下属性：

若对 XMLSocket.connect() 方法的调用尝试连接到调用方安全沙箱外部的服务器或低于 1024 的端口，则进行调度。

此事件具有以下属性：

另请参见

1. XMLSocketExample 构造函数创建名为 socket 的 XMLSocket 实例，并将 socket 传递给 ConfigureListeners()（如下所述），然后使用主机名“localhost”和端口号 8080 调用 connect() XMLSocket 的方法。
2. 随后调用 configureListeners() 方法，该方法为每个受支持的 XMLSocket 事件添加侦听器：
   • closeHandler()：侦听 close 事件，在网络连接关闭后调度该事件。
   • connectHandler()：侦听 connect 事件，在建立网络连接后调度该事件。
   • dataHandler()：侦听 data 事件，在 XMLSocket 每次接收新数据时调度该事件。
   • progressHandler()：侦听 progress 事件，已调用 send() 并且发送正在进行时调度该事件。
   • securityErrorHandler()：侦听 securityError 事件，如果试图使用错误的本地回放安全性设置或端口号低于 1024 的端口访问 XMLSocket，则调度该事件。
   • ioErrorHandler()：侦听 ioError 事件，仅当发送或接收数据的操作失败时，才会发生该事件。

注意：

• 您将需要编译 SWF 文件，将“本地回放安全性”设置为“只访问网络”。
• 若要让本示例正常工作，需使用在 [yourDomain] 上运行的服务器，并且使用 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);
        }
    }
}