XML 类

可用性

Flash Player 5(已成为 Flash Player 6 本身的对象,Flash Player 6 大大提高了性能)。

说明

使用 XML 类的方法和属性可以加载、分析、发送、生成和操作 XML 文档树。

必须先使用构造函数 new XML() 创建 XML 对象,然后才能调用 XML 类的方法。

XML 类的方法摘要

方法

说明

XML.addRequestHeader()

添加或更改 POST 操作的 HTTP 标头。

XML.appendChild()

在指定对象的子级列表结尾追加一个节点。

XML.cloneNode()

克隆指定的节点,并可选择递归克隆所有子级。

XML.createElement()

创建一个新的 XML 元素。

XML.createTextNode()

创建一个新的 XML 文本节点。

XML.getBytesLoaded()

返回为指定 XML 文档加载的字节数。

XML.getBytesTotal()

返回 XML 文档的大小,以字节为单位。

XML.hasChildNodes()

如果指定的节点有子级节点,则返回 true;否则返回 false

XML.insertBefore()

在指定节点的子级列表中的一个现有节点之前插入节点。

XML.load()

从 URL 中加载文档(由 XML 对象指定)。

XML.parseXML()

将 XML 文档分析为指定的 XML 对象树。

XML.removeNode()

从指定节点的父级中将该节点删除。

XML.send()

将指定的 XML 对象发送到 URL。

XML.sendAndLoad()

将指定的 XML 对象发送到 URL,并将服务器响应加载到另一 XML
对象中。

XML.toString()

将指定的节点与其任何子级转换为 XML 文本。

XML 类的属性摘要

属性

说明

XML.contentType

表示传输到服务器的 MIME 类型。

XML.docTypeDecl

设置和返回关于 XML 文档的 DOCTYPE 声明的信息。

XML.firstChild

只读;引用指定节点列表中的第一个子级。

XML.ignoreWhite

当设置为 true 时,在分析过程中将放弃仅包含空白的文本节点。

XML.lastChild

引用指定节点列表中的最后一个子级。

XML.loaded

只读;检查指定的 XML 对象是否已加载。

XML.nextSibling

只读;引用父级节点的子级列表中的下一个同级。

XML.nodeName

XML 对象的节点名称。

XML.nodeType

指定节点的类型(XML 元素或文本节点)。

XML.nodeValue

如果指定节点为文本节点,则为该节点的文本。

XML.parentNode

只读;引用指定节点的父级节点。

XML.previousSibling

只读;引用父级节点的子级列表中的前一个同级。

XML.status

一个数字状态代码,指示 XML 文档分析操作成功或失败。

XML.xmlDecl

指定有关文档的 XML 声明的信息。

XML 类的集合摘要

方法

说明

XML.attributes

返回一个包含指定节点所有属性的关联数组。

XML.childNodes

只读;返回一个包含对指定节点的子级节点的引用的数组。

XML 类的事件处理函数摘要

事件处理函数

说明

XML.onData

一个事件处理函数,当 XML 文本从服务器上被完全下载时,或者当从服务器上下载 XML 文本的过程中出现错误时进行调用。

XML.onLoad()

一个事件处理函数,它返回一个布尔值,指示是否用 XML.load()XML.sendAndLoad() 成功加载了该 XML 对象。

XML 类的构造函数

可用性

Flash Player 5。

用法

new XML([source])

参数

source 对其进行分析以创建新的 XML 对象的 XML 文本。

返回

无。

说明

构造函数;创建一个新的 XML 对象。必须先使用构造函数创建一个 XML 对象,然后才能调用 XML 类的方法。

注意:createElement()createTextNode() 方法是用于在 XML 文档树中创建元素和文本节点的“构造函数”方法。

示例

用法 1:下面的示例创建一个新的空 XML 对象。

my_xml = new XML();

用法 2:下面的示例通过分析 source 参数中指定的 XML 文本创建一个 XML 对象,并使用得到的 XML 文档树填充新创建的 XML 对象。

anyOtherXML = new XML("<state>California<city>san francisco</city></state>");

另请参见

XML.createElement()XML.createTextNode()