指定是否应为此请求处理身份验证请求，如果是，则为 true，否则为 false。如果为 false，则验证挑战返回 HTTP 错误。

支持的身份验证方法有：

• Windows — HTTP 基本/摘要、Windows 集成式身份验证（包括 NTLM 和 Kerberos）、SSL 证书身份验证。
• Mac — HTTP 基本/摘要、NTLM、SSL 证书身份验证。

注意：FileReference.upload()、FileReference.download() 和 HTMLLoader.load() 方法不支持 URLRequest.authenticate 属性。

默认值为 true.

另请参见

指定是否应为此请求缓存成功的响应数据。设置为 true 时，AIR 应用程序将使用操作系统的 HTTP 缓存。

注意：HTMLLoader.load() 方法不支持 URLRequest.cacheResponse 属性。

默认值为 true.

另请参见

data 属性中内容的 MIME 内容类型。

默认值为 application/x-www-form-urlencoded。

注意：FileReference.upload()、FileReference.download() 和 HTMLLoader.load() 方法不支持 URLRequest.contentType 属性。

发送 POST 请求时，contentType 和 data 属性的值必须正确对应。contentType 属性的值指示服务器如何解释 data 属性的值。

• 如果 data 属性的值是一个 URLVariables 对象，则 contentType 的值必须是 application/x-www-form-urlencoded。
• 如果 data 属性的值为其他类型，则 contentType 的值应指示将要发送的 POST 数据的类型（该数据为 data 属性的值中包含的二进制或字符串数据）。
• 对于 FileReference.upload()，请求的内容类型将自动设置为 multipart/form-data 并忽略 contentType 属性的值。

在 Flash Player 10 和更高版本中，如果使用包含上载（由 POST 体内的“content-disposition”标头中的“filename”参数表示）的 multipart Content-Type（例如“multipart/form-data”），则 POST 操作会受应用于上载的安全规则的约束：

• 必须执行 POST 操作以响应用户启动的操作（如鼠标单击或按键）。
• 如果 POST 操作是跨域的（POST 目标与发送 POST 请求的 SWF 文件不在同一台服务器上），则目标服务器必须提供一个允许跨域访问的 URL 策略文件。

另外，对于任何 multipart Content-Type，语法必须有效（根据 RFC2046 标准）。如果语法无效，则 POST 操作受应用于上载的安全规则约束。

另请参见

一个对象，它包含将随 URL 请求一起传输的数据。

该属性与 method 属性配合使用。当 method 值为 GET 时，将使用 HTTP 查询字符串语法将 data 值追加到 URLRequest.url 值。当 method 值为 POST（或 GET 之外的任何值）时，将在 HTTP 请求体中传输 data 值。

URLRequest API 支持二进制 POST，并支持 URL 编码变量和字符串。该数据对象可以是 ByteArray、URLVariables 或 String 对象。

该数据的使用方式取决于所用对象的类型：

• 如果该对象为 ByteArray 对象，则 ByteArray 对象的二进制数据用作 POST 数据。对于 GET，不支持 ByteArray 类型的数据。对于 FileReference.upload() 和 FileReference.download()，也不支持 ByteArray 类型的数据。
• 如果该对象是 URLVariables 对象，并且该方法是 POST，则使用 x-www-form-urlencoded 格式对变量进行编码，并且生成的字符串会用作 POST 数据。一种例外情况是对 FileReference.upload() 的调用，在该调用中变量将作为 multipart/form-data 发布中的单独字段进行发送。
• 如果该对象是 URLVariables 对象，并且该方法是 GET，则 URLVariables 对象将定义要随 URLRequest 对象一起发送的变量。
• 否则，该对象会转换为字符串，并且该字符串会用作 POST 或 GET 数据。

在方法（如 navigateToURL() 或 FileReference.upload()）使用 URLRequest 对象前，不会发送该数据。

注意：contentType 值必须与 data 属性中的数据类型对应。请参阅 contentType 属性说明中的注释。

另请参见

package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLVariables;

    public class URLVariablesExample extends Sprite {

        public function URLVariablesExample() {
            var url:String = "http://www.[yourDomain].com/application.jsp";
            var request:URLRequest = new URLRequest(url);
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date().getTime();
            variables.exampleUserLabel = "guest";
            request.data = variables;
            navigateToURL(request);
        }
    }
}

唯一地标识将存储到 Flash Player 缓存中（或从中检索）的已签名 Adobe 平台组件的字符串。Adobe 平台组件是一个签名文件（SWZ 文件），其中包含永久缓存在用户计算机上的 SWF 内容。Adobe 对所有 SWZ 进行签名。摘要对应于单个缓存文件；如果对该文件进行了任何更改，则其摘要的更改将以不可预知的方式进行。通过使用摘要，您可以跨多个域验证缓存文件。具有相同摘要的两个文件是同一个文件，具有不同摘要的两个文件是不同的文件。实际上无法创建文件来“窃听”摘要以假装是另一个摘要。此属性仅适用于 SWF 内容，不适用于在 AIR 中运行的 JavaScript 代码。

摘要基于 SHA-256 消息摘要算法（长度为 64 个字符，采用十六进制格式）。

例如，Flex SDK 包括 Flex 框架的 SWZ（而且它为该 SWZ 文件提供了摘要字符串）。可以将此 SWZ 发布到您的 Web 服务器上并加载到 SWF 文件中（使用 URLLoader 对象的 load() 方法）。如果最终用户的计算机已缓存了匹配的 SWZ 文件，则应用程序将使用此缓存的 SWZ 文件。（SWZ 文件在其 digest 与您提供的摘要匹配时匹配。）否则，应用程序将从您指定的 URL 下载 SWZ 文件。

仅在 URLLoader.load() 方法调用中使用的 URLRequest 对象中设置 digest 参数即可加载 SWZ 文件。如果 URLRequest 对象的 digest 属性在用于其它方法时进行了设置，则应用程序将引发 IOError 异常。

var myURLReq:URLRequest = new URLRequest();
myURLReq.url = "http://yourdomain/users/jdoe/test01/_rsc/Automated/AssetCaching_rsc/test01/rsl.swz";
myURLReq.digest = "3B0AA28C7A990385E044D80F5637FB036317BB41E044D80F5637FB036317BB41";
var myURLLoader:URLLoader = new URLLoader();
myURLLoader.dataFormat = URLLoaderDataFormat.BINARY;
myURLLoader.addEventListener("complete", onC);

myURLLoad.load(myURLReq);

function onC(e) {
    var someLoader:Loader = new Loader();
    addChild(someLoader);
    someLoader.loadBytes((ByteArray)(myURLLoad.data)); 
}

指定是否要遵循重定向，如果是，则为 true，否则为 false。

注意：FileReference.upload()、FileReference.download() 和 HTMLLoader.load() 方法不支持 URLRequest.followRedirects 属性。

默认值为 true.

另请参见

指定 HTTP 协议堆栈是否应管理此请求的 cookie。如果为 true，则将 cookie 添加到请求中并记住响应 cookie。如果为 false，则不 将 cookie 添加到请求中且不 记住响应 cookie，但用户可以通过直接处理标头来自行管理 cookie。

在 Mac OS 上，cookie 与 Safari 共享。清除 Mac OS 上的 cookie：

1. 打开 Safari。
2. 选择“Safari”>“首选参数”，然后单击“安全”面板。
3. 单击“显示 Cookie”按钮。
4. 单击“全部删除”按钮。

清除 Windows 上的 cookie：

1. 打开“Internet 属性”控制面板并单击“常规”选项卡。
2. 单击“删除 Cookie”按钮。

默认值为 true.

另请参见

控制 HTTP 表单提交方法。

对于在 Flash Player 中（在浏览器中）运行的 SWF 内容，此属性限制为 GET 或 POST 操作，有效值为 URLRequestMethod.GET 或 URLRequestMethod.POST。

对于在 Adobe AIR 中运行的内容，如果该内容位于应用程序安全沙箱内，则可以使用任何字符串值。否则，与在 Flash Player 中运行的内容一样，仅能使用 GET 或 POST 操作，有效值为 URLRequestMethod.GET 或 URLRequestMethod.POST。

对于在 Adobe AIR 中运行的内容，当使用 navigateToURL() 函数时，运行时将使用 POST 方法的 URLRequest（其 method 属性设置为 URLRequestMethod.POST）视为使用 GET 方法。

注意：如果在 Flash Player 中运行并且引用的表单没有正文，则即使将方法设置为 URLRequestMethod.POST，Flash Player 也会自动使用 GET 操作。因此，建议始终包括“虚拟”正文以确保使用正确的 method。

默认值为 URLRequestMethod.GET.

另请参见

package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLRequestMethod;
    import flash.net.URLVariables;

    public class URLRequest_method extends Sprite {

        public function URLRequest_method() {
            var url:String = "http://www.[yourDomain].com/application.jsp";
            var request:URLRequest = new URLRequest(url);
            
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date().getTime();
            variables.exampleUserLabel = "guest";
            request.data = variables;
            request.method = URLRequestMethod.POST;
            
            navigateToURL(request);
        }
    }
}

要追加到 HTTP 请求的 HTTP 请求标头的数组。该数组由 URLRequestHeader 对象组成。数组中的每一对象必须是包含一个名称字符串和一个值字符串的 URLRequestHeader 对象，如下所示：

var rhArray:Array = new Array(new URLRequestHeader("Content-Type", "text/html"));

Flash Player 和 AIR 运行时对请求标头强加AIR 运行时对请求标头强加某些限制；有关详细信息，请参阅 URLRequestHeader 类的描述。

并非所有接受 URLRequest 参数的方法都支持 requestHeaders 属性，请参阅有关调用的方法的文档。例如，FileReference.upload() 和 FileReference.download() 方法不支持 URLRequest.requestHeaders 属性。

由于存在浏览器限制，因此仅对 POST 请求支持自定义 HTTP 请求标头，而对 GET 请求不提供相应支持。

另请参见

所请求的 URL。

确保对统一资源定位器规范（请参阅 http://www.faqs.org/rfcs/rfc1738.html）中说明为不安全的字符或 URLRequest 对象的 URL 架构中保留的字符（如果未用于其保留用途）进行编码。例如，按照“http://www.example.com/orderForm.cfm?item=%23B-3&discount=50%25”的规定，对百分比符号 (%) 使用“%25”，对数字符号 (#) 使用“%23”。

默认情况下，除非内容在 Adobe AIR 应用程序安全沙箱中运行，否则 URL 必须与执行调用的文件位于同一域中。若要从其他域中加载数据，请在承载数据的服务器上放置一个 URL 策略文件。有关详细信息，请参阅 URLRequest 类的说明。

对于在 Adobe AIR 中运行的内容，应用程序安全沙箱中的文件（使用 AIR 应用程序安装的文件）可以使用以下任一 URL 方案访问 URL：

• http 和 https
• file
• app-storage
• app

注意：AIR 和 Flash Player 9.0.115.0 及更高版本支持 IPv6（Internet 协议版本 6）。IPv6 是支持 128 位地址的 Internet 协议版本（它是支持 32 位地址的早期 IPv4 协议的改进版本）。您可能需要在网络接口中激活 IPv6。有关详细信息，请参阅承载数据的操作系统的帮助。如果承载系统上支持 IPv6，则可以在用方括号 ([]) 括起的 URL 中指定数字 IPv6 文本地址，如下所示。

rtmp://[2001:db8:ccc3:ffff:0:444d:555e:666f]:1935/test

另请参见

指定在此 URLRequest 获取数据之前是否应查询本地缓存。

注意：HTMLLoader.load() 方法不支持 URLRequest.useCache 属性。

默认值为 true.

另请参见

指定要在 HTTP 请求中使用的用户代理字符串。

默认值是由 Flash Player 使用的同一用户代理字符串，该字符串在 Mac、Linux 和 Windows 中有所不同。

注意：在将 URLRequest 对象与 HTMLLoader 对象的 load() 方法一起使用时，此属性不影响用户代理字符串。若要设置 HTMLLoader 对象的用户代理字符串，请设置 HTMLLoader 对象的 userAgent 属性或设置静态 URLRequestDefaults.userAgent 属性。

另请参见

创建 URLRequest 对象。如果 System.useCodePage 为 true，则使用系统代码页对该请求进行编码，而不使用 Unicode。如果 System.useCodePage 为 false，则使用 Unicode 对该请求进行编码，而不使用系统代码页。

另请参见

若要运行该示例，请将名为 XMLFile.xml 的文件与 SWF 文件放在同一个目录下。

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

    public class URLRequestExample extends Sprite {

        public function URLRequestExample() {
            var loader:URLLoader = new URLLoader();
            configureListeners(loader);

            var request:URLRequest = new URLRequest("XMLFile.xml");
            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);
        }

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