User Guide

XMLSocket.onData 1067
XMLSocket.onData
Availability
Flash Player 5.
Usage
XMLSocket.onData = function(src:String) {
// your statements here
}
Parameters
src
A string containing the data sent by the server.
Returns
Nothing.
Description
Event handler; invoked when a message has been downloaded from the server, terminated by a
zero (0) byte. You can override
XMLSocket.onData to intercept the data sent by the server
without parsing it as XML. This is a useful if you’re transmitting arbitrarily formatted data
packets, and you’d prefer to manipulate the data directly when it arrives, rather than have Flash
Player parse the data as XML.
By default, the
XMLSocket.onData method invokes the XMLSocket.onXML method. If you
override
XMLSocket.onData with custom behavior, XMLSocket.onXML is not called unless you
call it in your implementation of
XMLSocket.onData.
Example
In this example, the src parameter is a string containing XML text downloaded from the server.
The zero (0) byte terminator is not included in the string.
XMLSocket.prototype.onData = function (src) {
this.onXML(new XML(src));
}