MACROMEDIA FLEX-FLEX ACTIONSCRIPT LANGUAGE, Reference

Page: 487 / 830

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