(仅限 AIR)
flash.net
public class URLRequestDefaults
继承URLRequestDefaults Inheritance Object

运行时版本: AIR 1.0

URLRequestDefaults 类包含一些静态属性,可以设置这些属性以便为 URLRequest 类的属性定义默认值。该类还包括一个静态方法 URLRequestDefaults.setLoginCredentialsForHost(),使用该方法可以定义请求的默认身份验证凭据。URLRequest 类定义要在 HTTP 请求中使用的信息。

URLRequest 对象中设置的任何属性都会覆盖为 URLRequestDefaults 类设置的那些静态属性。

URLRequestDefault 设置仅适用于调用方应用程序域中的内容,但有一个例外:通过调用 URLRequestDefaults.setLoginCredentialsForHost() 进行的设置适用于当前正在运行的应用程序中的所有应用程序域。

只有运行在应用程序安全沙箱中的 Adobe® AIR 内容才能使用 URLRequestDefaults 类。访问此类的成员或属性时,其他内容会导致引发 SecurityError。

另请参见

URLRequest


公共属性
 属性定义方
  AIR-only authenticate : Boolean
[静态] URLRequest 对象的 authenticate 属性的默认设置。
URLRequestDefaults
  AIR-only cacheResponse : Boolean
[静态] URLRequest 对象的 cacheResponse 属性的默认设置。
URLRequestDefaults
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  AIR-only followRedirects : Boolean
[静态] URLRequest 对象的 followRedirects 属性的默认设置。
URLRequestDefaults
  AIR-only manageCookies : Boolean
[静态] URLRequest 对象的 manageCookies 属性的默认设置。
URLRequestDefaults
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  AIR-only useCache : Boolean
[静态] URLRequest 对象的 useCache 属性的默认设置。
URLRequestDefaults
  AIR-only userAgent : String
[静态] URLRequest 对象的 userAgent 属性的默认设置。
URLRequestDefaults
公共方法
 方法定义方
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
  
AIR-only setLoginCredentialsForHost(hostname:String, user:String, password:String):*
[静态] 为选定的主机设置默认用户和密码凭据。
URLRequestDefaults
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
属性详细信息
AIR-only authenticate属性
authenticate:Boolean  [读写]

运行时版本: AIR 1.0

URLRequest 对象的 authenticate 属性的默认设置。在 URLRequest 对象中设置 authenticate 属性将覆盖此默认设置。

注意:此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。

默认值为 true.



实现
    public static function get authenticate():Boolean
    public function set authenticate(value:Boolean):void

引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。

另请参见

AIR-only cacheResponse属性 
cacheResponse:Boolean  [读写]

运行时版本: AIR 1.0

URLRequest 对象的 cacheResponse 属性的默认设置。在 URLRequest 对象中设置 cacheResponse 属性将覆盖此默认设置。设置为 true 时,AIR 应用程序的默认行为是使用操作系统的 HTTP 缓存。此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。

默认值为 true.



实现
    public static function get cacheResponse():Boolean
    public function set cacheResponse(value:Boolean):void

引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。

另请参见

AIR-only followRedirects属性 
followRedirects:Boolean  [读写]

运行时版本: AIR 1.0

URLRequest 对象的 followRedirects 属性的默认设置。在 URLRequest 对象中设置 followRedirects 属性将覆盖此默认设置。此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。

默认值为 true.



实现
    public static function get followRedirects():Boolean
    public function set followRedirects(value:Boolean):void

引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。

另请参见

AIR-only manageCookies属性 
manageCookies:Boolean  [读写]

运行时版本: AIR 1.0

URLRequest 对象的 manageCookies 属性的默认设置。在 URLRequest 对象中设置 manageCookies 属性将覆盖此默认设置。

注意:此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。

默认值为 true.



实现
    public static function get manageCookies():Boolean
    public function set manageCookies(value:Boolean):void

引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。

另请参见

AIR-only useCache属性 
useCache:Boolean  [读写]

运行时版本: AIR 1.0

URLRequest 对象的 useCache 属性的默认设置。在 URLRequest 对象中设置 useCache 属性将覆盖此默认设置。此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。

默认值为 true.



实现
    public static function get useCache():Boolean
    public function set useCache(value:Boolean):void

引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。

另请参见

AIR-only userAgent属性 
userAgent:String  [读写]

运行时版本: AIR 1.0

URLRequest 对象的 userAgent 属性的默认设置。在 URLRequest 对象中设置 userAgent 属性将覆盖此默认设置。

这也是用于所有 HTMLLoader 对象(调用 HTMLLoader 对象的 load() 方法时使用)的默认用户代理字符串。设置 HTMLLoader 对象的 userAgent 属性将覆盖 URLRequestDefaults.userAgent 设置。

此默认值随着运行时操作系统(如 Mac OS、Linux 或 Windows)、运行时语言和运行时版本而变化,如下面的示例所示:



实现
    public static function get userAgent():String
    public function set userAgent(value:String):void

引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。

另请参见

方法详细信息
AIR-only setLoginCredentialsForHost()方法
public static function setLoginCredentialsForHost(hostname:String, user:String, password:String):*

运行时版本: AIR 1.0

为选定的主机设置默认用户和密码凭据。这些设置适用于应用程序的所有应用程序域中的 URLRequest 对象,而不仅仅适用于调用此方法的对象的应用程序域中的 URLRequest 对象(但 URLRequest 类的静态属性只适用于调用方的应用程序域)。当应用程序的另一部分登录时,这可以让整个应用程序的内容登录(不管该内容位于哪个应用程序域)。

注意在 Mac OS 中运行的应用程序:在 Mac OS 中调用此方法时,应用程序将对指定主机使用这些凭据,直到应用程序关闭为止,即使随后对同一主机调用 URLRequestDefaults.setLoginCredentialsForHost() 也是如此。但如果服务器拒绝此方法指定的凭据,则将识别随后对 URLRequestDefaults.setLoginCredentialsForHost() 方法(对于同一主机)的调用。

注意:此方法不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。

参数

hostname:String — 应用用户名和密码的主机名称。此名称可以是域,如“www.example.com”;也可以是域和端口号,如“www.example.com:80”。请注意,“example.com”“www.example.com”“sales.example.com”均视为唯一的主机。
 
user:String — 要在针对指定主机进行的请求身份验证中使用的默认用户名。
 
password:String — 要在针对指定主机进行的请求身份验证中使用的默认密码。

返回
*

引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。