window.runtime 属性window.runtime.flash.net.URLRequestDefaults
继承URLRequestDefaults Inheritance Object
运行时版本:  1.0

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

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

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

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

另请参见

URLRequest


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

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

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

默认值为 true.


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

另请参见

cacheResponse属性 
cacheResponse:Boolean
运行时版本:  1.0

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

默认值为 true.


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

另请参见

followRedirects属性 
followRedirects:Boolean
运行时版本:  1.0

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

默认值为 true.


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

另请参见

manageCookies属性 
manageCookies:Boolean
运行时版本:  1.0

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

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

默认值为 true.


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

另请参见

useCache属性 
useCache:Boolean
运行时版本:  1.0

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

默认值为 true.


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

另请参见

userAgent属性 
userAgent:String
运行时版本:  1.0

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

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

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


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

另请参见

方法详细信息
setLoginCredentialsForHost()方法
function setLoginCredentialsForHost(hostname:String, user:String, password:String):*
运行时版本:  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 应用程序安全沙箱中。