Indica si este objeto XMLSocket está conectado actualmente. Para comprobar si la conexión es correcta, también se puede registrar para los eventos connect y ioError.

Véase también

Crea un nuevo objeto XMLSocket. El objeto XMLSocket no está conectado inicialmente a ningún servidor. Debe llamar al método XMLSocket.connect() para conectar el objeto con un servidor.

Véase también

Cierra la conexión especificada por el objeto XMLSocket. El evento close sólo se distribuye si el servidor cierra la conexión; no se distribuye al llamar al método close().

Véase también

Establece una conexión con el servidor de Internet especificado mediante el puerto TCP indicado. De forma predeterminada, sólo es posible conectar con el puerto 1024 o superiores, a no ser que se utilice un archivo de política.

Si especifica el valor null para el parámetro host, el servidor con el que se entra en contacto es en el que reside el archivo SWF que llama a XMLSocket.connect(). Por ejemplo, si el archivo SWF se ha descargado de www.adobe.com, especificar null para el parámetro host equivaldrá a introducir la dirección IP de www.adobe.com.

En archivos SWF que se ejecuten en una versión del reproductor anterior a Flash Player 7, host debe estar en el mismo superdominio que el archivo SWF que emite esta llamada. Por ejemplo, un archivo SWF situado en www.adobe.com puede enviar o recibir variables de un archivo SWF situado en store.adobe.com porque ambos archivos se encuentran en el mismo superdominio, denominado adobe.com.

En archivos SWF de cualquier versión que se ejecuten en Flash Player 7 o posterior, host debe estar exactamente en el mismo dominio. Por ejemplo, un archivo SWF situado en www.adobe.com publicado para Flash Player 5, pero abierto en Flash Player 7 o en una versión posterior sólo puede enviar o recibir variables de archivos SWF que también se encuentren en www.adobe.com. Si desea enviar o recibir variables de un dominio diferente, puede colocar un archivo de política entre dominios en el servidor en el que se alberga el archivo SWF al que se está accediendo.

Asimismo, se puede impedir que un archivo SWF utilice este método si define el parámetro allowNetworking de las etiquetas object y embed de la página HTML que aloja el contenido SWF.

Para más información, consulte las siguientes secciones:

• El capítulo de seguridad de la guía Programación con ActionScript 3.0 y los últimos comentarios realizados en LiveDocs.
• El documento técnico sobre la seguridad de Flash Player 9.

Parámetros

Véase también

Convierte el objeto XML o los datos especificados en el parámetro object en una cadena y la transmite al servidor seguida de un byte cero (0). Si object es un objeto XML, la cadena es una representación textual XML del objeto XML. La operación de envío (send) es asíncrona; se devuelve inmediatamente, pero puede que los datos se transmitan posteriormente. El método XMLSocket.send() no devuelve ningún valor que indique si los datos se han transmitido correctamente.

Si no conecta el objeto XMLSocket al servidor mediante XMLSocket.connect()), la operación XMLSocket.send() generará un error.

Parámetros

Véase también

Se distribuye cuando el servidor cierra la conexión de socket. El evento close sólo se distribuye si el servidor cierra la conexión; no se distribuye al llamar al método XMLSocket.close().

Este evento tiene las propiedades siguientes:

Se distribuye tras realizar una llamada correcta al método XMLSocket.connect().

Este evento tiene las propiedades siguientes:

Se distribuye una vez enviados o recibidos datos sin formato.

Este evento tiene las propiedades siguientes:

Se distribuye cuando se produce un error de entrada o salida que provoca que una operación de envío o recepción se realice incorrectamente.

Este evento tiene las propiedades siguientes:

Se distribuye si la llamada al método XMLSocket.connect() intenta conectar con un servidor fuera del entorno limitado de seguridad del elemento que realiza la llamada o con un puerto inferior al 1024.

Este evento tiene las propiedades siguientes:

Véase también

1. El constructor XMLSocketExample crea una instancia de XMLSocket denominada socket y transfiere socket a ConfigureListeners() (descrito a continuación). Posteriormente, llama al método connect() de XMLSocket utilizando el nombre de host "localhost" y el número de puerto 8080.
2. Se llama al método configureListeners(), que añade detectores para cada uno de los eventos XMLSocket admitidos:
   • closeHandler(): detecta el evento close, que se distribuye una vez cerrada la conexión de red.
   • connectHandler(): detecta el evento connect, que se distribuye al establecer la conexión de red.
   • dataHandler(): detecta eventos data, que se distribuyen cada vez que XMLSocket recibe nuevos datos.
   • progressHandler(): detecta eventos progress, que se distribuyen cuando se realiza una llamada a send() y durante el proceso de envío.
   • securityErrorHandler(): detecta eventos securityError, que se distribuirían si se intentase acceder al objeto XMLSocket con al configuración de seguridad de reproducción local errónea o si se utiliza un puerto inferior a 1024.
   • ioErrorHandler(): detecta eventos ioError, que se producirían sólo si hay algún error en el envío y la recepción de los datos.

Notas:

• Necesitará compilar el archivo SWF con la opción "Seguridad de reproducción local" establecida como "Acceso sólo a la red".
• Necesitará un servidor que se ejecute en [yourDomain] en el puerto 8080 para que este ejemplo funcione.

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