onXML = function(src:XML) {}

Invoked by the Flash Lite player when the specified XML object containing an XML document arrives over an open XMLSocket connection. An XMLSocket connection can be used to transfer an unlimited number of XML documents between the client and the server. Each document is terminated with a zero (0) byte. When the Flash Lite player receives the zero byte, it parses all the XML received since the previous zero byte or since the connection was established if this is the first message received. Each batch of parsed XML is treated as a single XML document and passed to the onXML() method.

The default implementation of this method performs no actions. To override the default implementation, you must assign a function containing actions that you define.

Parameters

src:XML - An XML object that contains a parsed XML document received from a server.

Example

The following function overrides the default implementation of the onXML() method in a simple chat application. The myOnXML() function instructs the chat application to recognize a single XML element, MESSAGE, in the following format:

<MESSAGE USER="John" TEXT="Hello, my name is John!" />. 
var socket:XMLSocket = new XMLSocket();

In the following example, the displayMessage() function is assumed to be a user-defined function that displays the message that the user receives:

socket.onXML = function (doc) {
    var e = doc.firstChild;
    if (e != null && e.nodeName == "MESSAGE") {
        displayMessage(e.attributes.user, e.attributes.text);
    }
}

See also

Array function