Indica se l'oggetto XMLSocket è correntemente connesso. È anche possibile verificare se la connessione è riuscita registrandosi per l'evento connect e l'evento ioError.

Vedere anche

Crea un nuovo oggetto XMLSocket. L'oggetto XMLSocket non è inizialmente connesso ad alcun server. È necessario chiamare XMLSocket.connect() per connettere l'oggetto a un server.

Vedere anche

Chiude la connessione specificata dall'oggetto XMLSocket. L'evento close viene inviato solo quando il server chiude la connessione; non viene inviato quando si chiama il metodo close().

Vedere anche

Stabilisce una connessione all'host Internet specificato mediante la porta TCP configurata. Per impostazione predefinita, è possibile connettersi solo alla porta 1024 o superiore, a meno che non si stia utilizzando un file dei criteri.

Se si specifica il valore null per il parametro host, l'host contattato è quello su cui risiede il file SWF che effettua la chiamata a XMLSocket.connect(). Ad esempio, se il file SWF è stato scaricato da www.adobe.com, specificare null per il parametro host equivale a immettere l'indirizzo IP di www.adobe.com.

Nei file SWF in esecuzione su una versione di Flash Player precedente alla 7, host deve trovarsi nello stesso superdominio del file SWF che effettua la chiamata. Ad esempio, un file SWF all'indirizzo www.adobe.com può inviare o ricevere le variabili da un file SWF presente in store.adobe.com poiché entrambi i file si trovano nello stesso superdominio di adobe.com.

Nei file SWF di qualunque versione eseguita in Flash Player 7 o superiore, host deve trovarsi esattamente nello stesso dominio. Ad esempio, un file SWF all'indirizzo www.adobe.com che è stato pubblicato per Flash Player 5, ma viene eseguito in Flash Player 7 o successivo, può inviare o ricevere variabili solo dai file SWF che si trovano all'indirizzo www.adobe.com. Per inviare o ricevere variabili da un dominio diverso, è possibile collocare un file dei criteri dei domini sul server su cui risiede il file SWF a cui si sta accedendo.

È possibile impedire che un file SWF utilizzi questo metodo impostando il parametro allowNetworking dei tag object ed embed nella pagina HTML che include il contenuto SWF.

Per ulteriori informazioni, vedere i seguenti riferimenti:

• Il capitolo Sicurezza di Flash Player nel volume Programmazione in ActionScript 3.0 e i commenti più recenti in LiveDocs
• Il White paper sulla sicurezza per Flash Player 9

Parametri

Vedere anche

Converte l'oggetto XML o i dati specificati nel parametro object in una stringa e la trasmette al server, seguita da un byte zero (0). Se object è un oggetto XML, la stringa è la rappresentazione testuale XML dell'oggetto XML. L'operazione di invio è asincrona; restituisce immediatamente un valore, ma è possibile che i dati vengano trasmessi in un secondo momento. Il metodo XMLSocket.send() non restituisce un valore che indica se i dati sono stati trasmessi correttamente.

Se non si connette l'oggetto XMLSocket al server (mediante XMLSocket.connect()), l'operazione XMLSocket.send() non riesce.

Parametri

Vedere anche

Inviato quando il server chiude la connessione socket. L'evento close viene inviato solo quando il server chiude la connessione; non viene inviato quando si chiama il metodo XMLSocket.close().

Questo evento ha le seguenti proprietà:

Inviato dopo una chiamata riuscita al metodo XMLSocket.connect().

Questo evento ha le seguenti proprietà:

Inviato dopo che sono stati inviati o ricevuti dei dati raw.

Questo evento ha le seguenti proprietà:

Inviato quando si verifica un errore di input/output che impedisce un'operazione di invio o ricezione.

Questo evento ha le seguenti proprietà:

Inviato se una chiamata al metodo XMLSocket.connect() tenta di connettersi a un server che si trova al di fuori della funzione di sicurezza sandbox del chiamante o di una porta con numero inferiore a 1024.

Questo evento ha le seguenti proprietà:

Vedere anche

1. La funzione di costruzione XMLSocketExample crea un'istanza XMLSocket denominata socket e passa socket a ConfigureListeners() (descritto di seguito), quindi chiama il metodo connect() di XMLSocket mediante il nome host "localhost" e il numero di porta 8080.
2. Viene quindi chiamato il metodo configureListeners() che aggiunge i listener per ognuno degli eventi XMLSocket supportati:
   • closeHandler(): intercetta l'evento close che viene inviato dopo la chiusura della connessione di rete.
   • connectHandler(): intercetta l'evento connect che viene inviato quando è stata stabilita una connessione di rete.
   • dataHandler(): intercetta gli eventi data che vengono inviati ogni volta che XMLSocket riceve nuovi dati.
   • progressHandler(): intercetta gli eventi progress, che vengono inviati quando è stata effettuata una chiamata a send() e mentre l'invio è in corso.
   • securityErrorHandler(): intercetta gli eventi securityError che sarebbero inviati se si tentasse di accedere a XMLSocket con l'impostazione di sicurezza per la riproduzione locale non corretta o utilizzando una porta con numero inferiore a 1024.
   • ioErrorHandler(): intercetta gli eventi ioError che si verificano solo se un'operazione di invio o ricezione dati non riesce.

Note:

• È necessario compilare il file SWF con l'opzione "Sicurezza riproduzione locale" impostato su "Accedi solo alla rete".
• Perché questo esempio funzioni, è necessario che un server sia in esecuzione su [yourDomain] utilizzando la porta 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);
        }
    }
}