XML.load()

可用性

Flash Player 5；行为在 Flash Player 7 中发生了变化。

用法

my_xml.load(url)

参数

url 要加载的 XML 文档所位于的 URL。如果发布此调用的 SWF 文件运行在 Web 浏览器上，则 url 必须与 SWF 文件位于同一个域中；有关详细信息，请参见下面的“说明”。

返回

无。

说明

方法；从指定的 URL 中加载 XML 文档，并使用下载的 XML 数据替换指定 XML 对象的内容。该 URL 是相对的，并且通过 HTTP 调用。加载过程是异步的；它不会在 load() 方法执行后立即结束。

在运行于 Flash Player 7 以前版本的播放器的 SWF 文件中，url 必须与发布此调用的 SWF 文件位于同一个超级域中。例如，位于 www.someDomain.com 的 SWF 文件可以从位于 store.someDomain.com 的 SWF 文件加载变量，这是因为这两个文件都在同一个超级域 someDomain.com 中。

在运行于 Flash Player 7 或更高版本的任何版本的 SWF 文件中，url 必须在同一个域中（请参见Flash Player 安全功能）。例如，位于 www.someDomain.com 的 SWF 文件只能从同样位于 www.someDomain.com 的 SWF 文件加载变量。如果要从其它域中加载变量，则可以在承载被访问的 SWF 文件的服务器上放置一个跨域策略文件。有关更多信息，请参见关于允许跨域数据加载。

执行 load() 时，XML 对象的属性 loaded 将被设置为 false。在 XML 数据下载完毕后，loaded 属性将被设置为 true，并调用 onLoad() 方法。直到 XML 数据完全下载后，才开始分析。如果该 XML 对象以前包含任何 XML 树，它们将被放弃。

您可以指定自己的事件处理函数来代替 onLoad() 方法。

示例

下面是一个使用 XML.load() 的简单示例：

doc = new XML();
doc.load ("theFile.xml");

另请参见

XML.loaded、XML.onLoad()