User Guide

1044 Chapter 2: ActionScript Language Reference
XML.onData
Availability
Flash Player 5.
Usage
my_xml.onData = function(src:String) {
// your statements here
}
Parameters
src
A string or undefined; the raw data, usually in XML format, that is sent by the server.
Returns
Nothing.
Description
Event handler; invoked when XML text has been completely downloaded from the server, or
when an error occurs downloading XML text from a server. This handler is invoked before the
XML is parsed, and you can use it to call a custom parsing routine instead of using the Flash
XML parser. The
src parameter is a string that contains XML text downloaded from the server,
unless an error occurs during the download, in which case the
src parameter is undefined.
By default, the
XML.onData event handler invokes XML.onLoad. You can override the
XML.onData event handler with custom behavior, but XML.onLoad is not called unless you call it
in your implementation of
XML.onData.
Example
The following example shows what the XML.onData event handler looks like by default:
XML.prototype.onData = function (src:String) {
if (src == undefined) {
this.onLoad(false);
} else {
this.parseXML(src);
this.loaded = true;
this.onLoad(true);
}
}
You can override the XML.onData event handler to intercept the XML text without parsing it.