指示加载操作期间到目前为止加载的字节数。

指示所下载数据中的字节总数。 正在进行加载操作时该属性包含 0，完成操作时会填充该属性。

从加载操作接收的数据。 只有完成加载操作时，才会填充该属性。 该数据的格式取决于 dataFormat 属性的设置：

如果 dataFormat 属性是 URLLoaderDataFormat.TEXT，则所接收的数据是一个包含已加载文件文本的字符串。

如果 dataFormat 属性是 URLLoaderDataFormat.BINARY，则所接收的数据是一个包含原始二进制数据的 ByteArray 对象。

如果 dataFormat 属性是 URLLoaderDataFormat.VARIABLES，则所接收的数据是一个包含 URL 编码变量的 URLVariables 对象。

另请参见

控制是以文本 (URLLoaderDataFormat.TEXT)、原始二进制数据 (URLLoaderDataFormat.BINARY) 还是 URL 编码变量 (URLLoaderDataFormat.VARIABLES) 接收下载的数据。

如果 dataFormat 属性的值是 URLLoaderDataFormat.TEXT，则所接收的数据是一个包含已加载文件文本的字符串。

如果 dataFormat 属性的值是 URLLoaderDataFormat.BINARY，则所接收的数据是一个包含原始二进制数据的 ByteArray 对象。

如果 dataFormat 属性的值是 URLLoaderDataFormat.VARIABLES，则所接收的数据是一个包含 URL 编码变量的 URLVariables 对象。

默认值为 URLLoaderDataFormat.TEXT.

另请参见

创建 URLLoader 对象。

另请参见

关闭进行中的加载操作。 任何正在进行中的加载操作将立即终止。 如果当前未对 URL 进行流式处理，将引发无效流错误。

从指定的 URL 发送和加载数据。 可以以文本、原始二进制数据或 URL 编码变量格式接收数据，这取决于为 dataFormat 属性所设置的值。 请注意 dataFormat 属性的默认值为文本。 如果想将数据发送至指定的 URL，则可以在 URLRequest 对象中设置 data 属性。

注意：如果要加载的文件包含非 ASCII 字符（在许多非英语的语言中出现），则建议使用 UTF-8 或 UTF-16 编码（而不是 ASCII 等非 Unicode 格式）来保存文件。

使用此方法时，请考虑 Flash Player 安全模型：

在 Flash Player 9 及更高版本中，可以在包含 SWF 内容的 HTML 页中设置 object 和 embed 标签的 allowNetworking 参数来防止 SWF 文件使用此方法。

对于 Flash Player 8 及更高版本：

• 如果执行调用的 SWF 文件在只能与本地文件系统内容交互的沙箱中，而目标资源来自网络沙箱，则不允许进行数据加载。
• 如果执行调用的 SWF 文件来自网络沙箱而目标资源在本地，也不允许进行数据加载。

对于 Flash Player 7 及更高版本网站，可通过跨域策略文件允许对资源进行跨域访问。 如果任何版本的 SWF 文件在 Flash Player 7 及更高版本中运行，则 url 必须位于完全相同的域中。 例如，位于 www.adobe.com 的 SWF 文件只能从同样位于 www.adobe.com 的源中加载数据。

有关详细信息，请参阅以下部分：

• security chapter（在《ActionScript 3.0 编程》一书中）和有关 LiveDocs 的最新注释
• Flash Player 9 Security White Paper

如果 SWF 文件在低于 Flash Player 7 版本的播放器中运行，则 url 必须与发出此调用的 SWF 文件位于同一个超级域中。 超级域可以通过删除文件 URL 最左侧的组成部分而得到。 例如，位于 www.adobe.com 的 SWF 文件可以从位于 store.adobe.com 的源中加载数据，这是因为这两个文件都在同一个名为 adobe.com 的超级域中。

参数

另请参见

在对所有已接收数据进行解码并将其放在 URLLoader 对象的 data 属性中以后调度。 调度该事件后，可以访问已接收的数据。

此事件具有以下属性：

另请参见

若对 URLLoader.load() 的调用尝试通过 HTTP 访问数据并且当前的 Flash Player 环境能够检测并返回该请求的状态代码，则进行调度。 （有些浏览器环境可能无法提供此信息。） 请注意：在发送任何 complete 或 error 事件之前还将发送 httpStatus 事件（如果有）。

此事件具有以下属性：

另请参见

若对 URLLoader.load() 的调用导致致命错误并因此终止了下载，则进行调度。

此事件具有以下属性：

另请参见

在调用 URLLoader.load() 方法和开始下载操作时调度。

此事件具有以下属性：

另请参见

在下载操作过程中收到数据时调度。

请注意，对于 URLLoader 对象，在完全接收数据前无法访问该数据。 因此，该 progress 事件仅用作有关下载进展的通知。 若要在完整下载前访问该数据，请使用 URLStream 对象。

此事件具有以下属性：

另请参见

若对 URLLoader.load() 的调用尝试从安全沙箱外部的服务器加载数据，则进行调度。

此事件具有以下属性：

另请参见

注意：若要运行此示例，请将名为 urlLoaderExample.txt 的文件与 SWF 文件放在同一目录下。 该文件应仅包含以下文本行：answer=42&question=unknown

该示例代码执行以下操作：

1. 该构造函数创建名为 loader 的 URLLoader 实例和名为 request URLRequest 的实例，后者包含要加载的文件的位置和名称。
2. loader 对象被传递给 configureListeners() 方法，该方法可为每个受支持的 URLLoader 事件添加侦听器。
3. 然后，request 对象被传递给 loader.load()，该方法可加载文本文件。
4. 当 URLLoader 完成文本文件的加载时，将引发 Event.COMPLETE event，同时触发 completeHandler() 方法。 completeHandler() 方法通过从该文件中加载的文本创建 URLVariables 对象。 URLVariables 对象将 URL 编码的名称/值对转换成 ActionScript 属性，从而更便于处理加载的数据。

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.*;

    public class URLLoaderExample extends Sprite {
        public function URLLoaderExample() {
            var loader:URLLoader = new URLLoader();
            configureListeners(loader);

            var request:URLRequest = new URLRequest("urlLoaderExample.txt");
            try {
                loader.load(request);
            } catch (error:Error) {
                trace("Unable to load requested document.");
            }
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        }

        private function completeHandler(event:Event):void {
            var loader:URLLoader = URLLoader(event.target);
            trace("completeHandler: " + loader.data);
    
            var vars:URLVariables = new URLVariables(loader.data);
            trace("The answer is " + vars.answer);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}