U-X > XML.onData |  |

XML.onData

XML.ondata, ondata, on data

Availability

Flash Player 5

Usage

    myXML.onData()

Parameters

None.

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 therefore can be used to call a custom parsing routine instead of using the Flash XML parser. The `XML.onData` method returns either the value `undefined`, or a string that contains XML text downloaded from the server. If the returned value is `undefined`, an error occurred while downloading the XML from the server.

By default, the `XML.onData` method invokes the `XML.onLoad` method. You can override the `XML.onData` method with your own behavior, but `XML.onLoad` will no longer be called unless you call it in your implementation of `XML.onData`.

Example

The following example shows what the `onData` method looks like by default:

    XML.prototype.onData = function (src) {
      if (src == undefined) {
        this.onLoad(false);
      } else {
        this.parseXML(src);
        this.loaded = true;
        this.onLoad(true);
      }
    }

The `XML.onData` method can be overridden to intercept the XML text without parsing it.