XMLSocket.onXML()

可用性

Flash Player 5。

用法

myXMLSocket.onXML(object) = function() {
  // 此处是您的语句
}

参数

object 一个 XML 对象，它包含从服务器上接收到的已经过分析的 XML 文档。 

返回

无。

说明

事件处理函数；在包含 XML 文档的指定 XML 对象通过打开的 XMLSocket 连接到达时，Flash Player 将调用此函数。XMLSocket 连接可用于在客户端与服务器之间传输数量无限的 XML 文档。每个文档都以 0（零）字节终止。当 Flash Player 收到 0 字节时，它分析自从前一个 0 字节以来收到的所有 XML，如果这是收到的第一条消息，则分析建立连接以来收到的所有 XML。每一批经过分析的 XML 都被视作单个 XML 文档，并被传递给 onXML 方法。

此方法的默认实现不执行任何动作。若要覆盖默认实现，必须指定一个包含您定义的动作的
函数。  

示例

下面的函数在一个简单的聊天应用程序中覆盖 onXML 方法的默认实现。函数 myOnXML 指示该聊天应用程序识别一个 XML 元素 (MESSAGE)，该元素的格式如下所示。

<MESSAGE USER="John" TEXT="Hello, my name is John!" />. 

必须首先在该 XMLSocket 对象中设置 onXML 处理函数，如下所示：

socket.onXML = myOnXML;

假定函数 displayMessage() 是一个用户定义的函数，该函数显示用户收到的消息。

function myOnXML(doc) {
  var e = doc.firstChild;
  if (e != null && e.nodeName == "MESSAGE") {
    displayMessage(e.attributes.user, e.attributes.text);
  }
}

另请参见

function