U-X > XML.onData

 

XML.onData

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.