flash.net
public final class URLLoaderDataFormat
继承URLLoaderDataFormat Inheritance Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

URLLoaderDataFormat 类提供了一些用于指定如何接收已下载数据的值。

查看示例



公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
公共方法
 方法定义方
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
公共常量
 常量定义方
  BINARY : String = "binary"
[静态] 指定以原始二进制数据形式接收下载的数据。
URLLoaderDataFormat
  TEXT : String = "text"
[静态] 指定以文本形式接收已下载的数据。
URLLoaderDataFormat
  VARIABLES : String = "variables"
[静态] 指定以 URL 编码变量形式接收下载的数据。
URLLoaderDataFormat
常量详细信息
BINARY常量
public static const BINARY:String = "binary"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

指定以原始二进制数据形式接收下载的数据。

TEXT常量 
public static const TEXT:String = "text"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

指定以文本形式接收已下载的数据。

VARIABLES常量 
public static const VARIABLES:String = "variables"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

指定以 URL 编码变量形式接收下载的数据。

示例 如何使用示例
URLLoaderDataFormatExample.as

下例使用 URLLoaderDataFormatExample 类显示在运行时加载的文件的数据格式和状态信息。这是使用以下步骤完成的:
  1. 类构造函数创建一个名为 loader 的 URLLoader 和一个名为 request 的 URLRequest 实例,后者为要加载的文件的位置和名称。
  2. loader 对象被传递给 configureListeners() 方法,该方法可为每个受支持的 URLLoader 事件添加侦听器:
    • completeHandler():侦听 complete 事件,在成功加载 TextFile.txt 后调度该事件。
    • openHandler():侦听 open 事件,开始下载 TextFile.txt(至播放器)时调度该事件。
    • progressHandler():侦听 progress 事件,在下载操作过程中收到数据时调度该事件。
    • securityErrorHandler():侦听 securityError 事件,如果访问文本文件时使用了错误的本地回放安全设置,则调度该事件。
    • httpStatusHandler():侦听 httpStatusHandler 事件,在此示例不调度该事件,因为 TextFile.txt 是本地文件。
    • ioErrorHandler():侦听 ioError 事件,仅当文件出现严重问题(如文件丢失)时才发生该事件。
  3. 随后 request 对象被传递给 loader.load() 方法,该方法会使用 DisplayObject 对象将文本文件加载到内存中。

注意:

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

    public class URLLoaderDataFormatExample extends Sprite {
        private var source:String = "TextFile.txt";
        private var dataFormat:String = URLLoaderDataFormat.TEXT;
        
        public function URLLoaderDataFormatExample () {
            var loader:URLLoader = new URLLoader();
            loader.dataFormat = dataFormat;
            configureListeners(loader);
            var request:URLRequest = new URLRequest(source);
            try {
                loader.load(request);
            } catch (error:Error) {
                trace("Error loading requested document: " + source);
            }
        }

        private function configureListeners(dispatcher:URLLoader):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);
            switch(loader.dataFormat) {
                case URLLoaderDataFormat.TEXT :
                    trace("completeHandler (text): " + loader.data);
                    break;
                case URLLoaderDataFormat.BINARY :
                    trace("completeHandler (binary): " + loader.data);
                    break;
                case URLLoaderDataFormat.VARIABLES :
                    trace("completeHandler (variables): " + loader.data);
                    break;
            }
        }

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

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

        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);
        }
    }
}