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