Flash CS3 Documentation

ActionScript 2.0 Language Reference > ActionScript classes > XML > onData (XML.onData handler)

onData (XML.onData 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.

Availability: ActionScript 1.0; Flash Player 5

Parameters

src:String - A string or undefined; the raw data, usually in XML format, that is sent by the server.

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.

See also

onLoad (XML.onLoad handler)

Flash CS3