User Guide

XMLSocket.onData 487
Description
Event handler; invoked by Flash Player when a connection request initiated through
XMLSocket.connect() has succeeded or failed. If the connection succeeded, the success
parameter is
true; otherwise the success parameter is false.
The default implementation of this method performs no actions. To override the default
implementation, you must assign a function containing custom actions.
See also
function, XMLSocket.connect()
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));
}