Gibt an, ob dieses XMLSocket-Objekt zurzeit verbunden ist. Sie können sich auch für die Ereignisse connect und ioError registrieren, um zu überprüfen, ob die Verbindung erfolgreich hergestellt werden konnte.

Siehe auch

Erstellt ein neues XMLSocket-Objekt. Das XMLSocket-Objekt ist zunächst nicht mit einem Server verbunden. Sie müssen die Methode XMLSocket.connect() aufrufen, um das Objekt mit einem Server zu verbinden.

Siehe auch

Schließt die durch das XMLSocket-Objekt angegebene Verbindung. Das Ereignis close wird nur ausgelöst, wenn der Server die Verbindung schließt. Es wird nicht ausgelöst, wenn Sie die Methode close() aufrufen.

Siehe auch

Stellt über den angegebenen TCP-Port eine Verbindung zum angegebenen Internet-Host her. Die Portnummer für die Verbindung muss größer oder gleich 1024 sein, es sei denn, Sie verwenden eine Richtliniendatei.

Wenn Sie für den Parameter host den Wert null angeben, wird der Host kontaktiert, auf dem die SWF-Datei gespeichert ist, die XMLSocket.connect() aufgerufen hat. Wenn die SWF-Datei beispielsweise von www.adobe.com heruntergeladen wurde, entspricht die Angabe von null für den host-Parameter der Eingabe der IP-Adresse für www.adobe.com.

Bei SWF-Dateien, die in einer vor Flash Player 7 liegenden Player-Version laufen, muss sich host in derselben Superdomäne befinden, wie die SWF-Datei, die diesen Aufruf ausgibt. Beispiel: Eine SWF-Datei unter www.adobe.com kann Variablen an eine SWF-Datei senden bzw. von einer SWF-Datei empfangen, die sich unter store.adobe.com befindet, da die Superdomäne adobe.com dieselbe ist.

Bei SWF-Dateien einer beliebigen Version, die in Flash Player 7 oder einer neueren Version ausgeführt werden, muss sich host in exakt derselben Domäne befinden. Beispiel: Eine SWF-Datei unter www.adobe.com, die für Flash Player 5 veröffentlicht wurde, aber in Flash Player 7 oder höher ausgeführt wird, kann nur Variablen an SWF-Dateien senden bzw. von SWF-Dateien empfangen, die sich ebenfalls unter www.adobe.com befinden. Wenn Sie beabsichtigen, Variablen von einer anderen Domäne zu empfangen bzw. an eine andere Domäne zu senden, können Sie eine domänenübergreifende Richtliniendatei auf den Hostserver der SWF-Datei laden, auf die zugegriffen werden soll.

Sie können eine SWF-Datei daran hindern, diese Methode aufzurufen, indem Sie in der HTML-Seite, die den SWF-Inhalt enthält, den Parameter allowNetworking der Tags object und embed festlegen.

Weitere Informationen finden Sie in den folgenden Abschnitten:

• Das Kapitel Sicherheit im Handbuch Programmieren mit ActionScript 3.0 und die neusten Kommentare zu den LiveDocs.
• Das Flash Player 9-Whitepaper zum Thema Sicherheit

Parameter

Siehe auch

Wandelt das mit dem Parameter object angegebene XML-Objekt bzw. die angegebenen Daten in einen String um und übermittelt diesen gefolgt von einem Null-Byte (0) an den Server. Wenn es sich bei object um ein XML-Objekt handelt, enthält der String die XML-Textdarstellung des XML-Objekts. Die send-Operation ist asynchron; es erfolgt zwar sofort eine Rückgabe, die Daten werden aber möglicherweise zu einem späteren Zeitpunkt gesendet. Die Methode XMLSocket.send() gibt keinen Wert zurück, der angibt, ob die Daten erfolgreich übermittelt wurden.

Wenn Sie das XMLSocket-Objekt nicht über XMLSocket.connect() mit dem Server verbinden, schlägt der XMLSocket.send()-Vorgang fehl.

Parameter

Siehe auch

Wird ausgelöst, wenn der Server die Socketverbindung schließt. Das Ereignis close wird nur ausgelöst, wenn der Server die Verbindung schließt. Es wird nicht ausgelöst, wenn Sie die Methode XMLSocket.close() aufrufen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird nach dem erfolgreichen Aufruf der Methode XMLSocket.connect() ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird nach dem Senden oder Empfangen von unformatierten Daten ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird beim Auftreten eines Eingabe/Ausgabe-Fehlers ausgelöst, durch den ein Sende- oder Empfangsvorgang fehlschlägt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn mit einem Aufruf der Methode XMLSocket.connect() versucht wird, eine Verbindung zu einem Server außerhalb der Sicherheits-Sandbox des Aufrufers oder zu einem Port mit einer niedrigeren Nummer als 1024 herzustellen.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Siehe auch

1. Der XMLSocketExample-Konstruktor erstellt eine XMLSocket-Instanz mit dem Namen socket, übergibt socket an ConfigureListeners() (siehe unten) und ruft dann die Methode connect() für die XMLSocket-Verbindung auf, wobei der Hostname "localhost" und die Portnummer 8080 verwendet werden.
2. Daraufhin wird die Methode configureListeners() aufgerufen, die für jedes unterstützte XMLSocket-Ereignis Listener hinzufügt:
   • closeHandler() : Listener für das Ereignis close, das nach dem Schließen der Netzwerkverbindung ausgelöst wird.
   • connectHandler() : Listener für das Ereignis connect, das nach dem Herstellen der Netzwerkverbindung ausgelöst wird.
   • dataHandler() : Listener für die data-Ereignisse, die jedes Mal ausgelöst werden, wenn über die XMLSocket-Verbindung neue Daten empfangen werden.
   • progressHandler(): Listener für die progress-Ereignisse, die beim Aufruf von send() und während des Sendevorgangs ausgelöst werden.
   • securityErrorHandler(): Listener für securityError-Ereignisse, die bei dem Versuch ausgelöst werden, mit der falschen Sicherheitseinstellung für die lokale Wiedergabe oder über einen Port mit einer niedrigeren Nummer als 1024 auf den XMLSocket-Server zuzugreifen.
   • ioErrorHandler(): Listener für ioError-Ereignisse, die ausgelöst werden, wenn das Senden oder Empfangen von Daten fehlschlägt.

Hinweise:

• Für die Kompilierung der SWF-Datei müssen Sie die Option "Sicherheit bei lokaler Wiedergabe" auf "Nur auf Netzwerk zugreifen" einstellen.
• Sie benötigen einen Server, der unter [yourDomain] ausgeführt wird und Port 8080 verwendet, damit dieses Beispiel funktioniert.

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