XML.onData

可用性

Flash Player 5

用法

my_xml.onData = function(src) {
  // 此处是您的语句
}

参数

src 服务器发送的原始数据，通常为 XML 格式。

返回

无。

说明

事件处理函数；当 XML 文本从服务器上被完全下载后，或当从服务器上下载 XML 文本的过程中出现错误时调用该处理函数。在分析 XML 之前调用这个处理函数，因此它可用于调用一个自定义分析例程，从而不必使用 Flash XML 分析器。XML.onData 方法或者返回 undefined 值，或者返回一个包含从服务器上下载的 XML 文本的字符串。如果返回值为 undefined，说明从服务器上下载 XML 时出现了错误。

默认情况下，XML.onData 方法将调用 XML.onLoad()。可以用您自己定义的行为覆盖
XML.onData 方法，但这时就不再调用 XML.onLoad() 了，除非在您的 XML.onData 实现中又调用了该方法。

示例

onData 方法的默认实现如下例所示：

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

可以覆盖 XML.onData 方法，从而截获 XML 文本而不对其进行分析。