| 包 | flash.net |
| 类 | public class URLRequestDefaults |
| 继承 | URLRequestDefaults  Object |
| 运行时版本: | AIR 1.0, Flash Lite 4 |
URLRequestDefaults.setLoginCredentialsForHost()，使用该方法可以定义请求的默认身份验证凭据。URLRequest 类定义要在 HTTP 请求中使用的信息。
URLRequest 对象中设置的任何属性都会覆盖为 URLRequestDefaults 类设置的那些静态属性。
URLRequestDefault 设置仅适用于调用方应用程序域中的内容，但有一个例外：通过调用 URLRequestDefaults.setLoginCredentialsForHost() 进行的设置适用于当前正在运行的应用程序中的所有应用程序域。
只有在应用程序安全沙箱中运行的 Adobe® AIR® 内容才能使用 URLRequestDefaults 类。访问此类的成员或属性时，其他内容会导致引发 SecurityError。
相关 API 元素
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| authenticate : Boolean [静态]
URLRequest 对象的 authenticate 属性的默认设置。 | URLRequestDefaults | ||
| cacheResponse : Boolean [静态]
URLRequest 对象的 cacheResponse 属性的默认设置。 | URLRequestDefaults | ||
 | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| followRedirects : Boolean [静态]
URLRequest 对象的 followRedirects 属性的默认设置。 | URLRequestDefaults | ||
| idleTimeout : Number [静态]
URLRequest 对象和 HTMLLoader 对象的 idleTimeout 属性的默认设置。 | URLRequestDefaults | ||
| manageCookies : Boolean [静态]
URLRequest 对象的 manageCookies 属性的默认设置。 | URLRequestDefaults | ||
| useCache : Boolean [静态]
URLRequest 对象的 useCache 属性的默认设置。 | URLRequestDefaults | ||
| userAgent : String [静态]
URLRequest 对象的 userAgent 属性的默认设置。 | URLRequestDefaults | ||
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
|
表示对象是否已经定义了指定的属性。 | Object | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
[静态]
为选定的主机设置默认用户和密码凭据。 | URLRequestDefaults | ||
|
设置循环操作动态属性的可用性。 | Object | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回指定对象的字符串表示形式。 | Object | |
|
返回指定对象的原始值。 | Object | |
authenticate | 属性 |
authenticate:Boolean| 运行时版本: | AIR 1.0, Flash Lite 4 |
URLRequest 对象的 authenticate 属性的默认设置。在 URLRequest 对象中设置 authenticate 属性将覆盖此默认设置。
注意：此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
默认值为 true。
实现
public static function get authenticate():Boolean public static function set authenticate(value:Boolean):void引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。
|
相关 API 元素
cacheResponse | 属性 |
cacheResponse:Boolean| 运行时版本: | AIR 1.0, Flash Lite 4 |
URLRequest 对象的 cacheResponse 属性的默认设置。在 URLRequest 对象中设置 cacheResponse 属性将覆盖此默认设置。设置为 true 时，AIR 应用程序的默认行为是使用操作系统的 HTTP 缓存。此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
默认值为 true。
实现
public static function get cacheResponse():Boolean public static function set cacheResponse(value:Boolean):void引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。
|
相关 API 元素
followRedirects | 属性 |
followRedirects:Boolean| 运行时版本: | AIR 1.0, Flash Lite 4 |
URLRequest 对象的 followRedirects 属性的默认设置。在 URLRequest 对象中设置 followRedirects 属性将覆盖此默认设置。此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
默认值为 true。
实现
public static function get followRedirects():Boolean public static function set followRedirects(value:Boolean):void引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。
|
相关 API 元素
idleTimeout | 属性 |
idleTimeout:Number| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 2 |
URLRequest 对象和 HTMLLoader 对象的 idleTimeout 属性的默认设置。
空闲超时是指客户端在建立连接之后、放弃请求之前等待服务器响应的时间（以毫秒为单位）。
它定义 URLRequest 或 HTMLLoader 对象使用的默认空闲超时。设置 URLRequest 对象或 HTMLLoader 对象中的 idleTimeout 属性将此覆盖默认设置。
当此属性设置为 0（默认值）时，运行时使用操作系统定义的默认空闲超时值。默认空闲超时值随操作系统（如 Mac OS、Linux 或 Windows）和操作系统版本而变化。
此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
默认值为 0。
实现
public static function get idleTimeout():Number public static function set idleTimeout(value:Number):void引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。
| |
RangeError — idleTimeout 值为负。
|
相关 API 元素
manageCookies | 属性 |
manageCookies:Boolean| 运行时版本: | AIR 1.0, Flash Lite 4 |
URLRequest 对象的 manageCookies 属性的默认设置。在 URLRequest 对象中设置 manageCookies 属性将覆盖此默认设置。
注意：此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
默认值为 true。
实现
public static function get manageCookies():Boolean public static function set manageCookies(value:Boolean):void引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。
|
相关 API 元素
useCache | 属性 |
useCache:Boolean| 运行时版本: | AIR 1.0, Flash Lite 4 |
URLRequest 对象的 useCache 属性的默认设置。在 URLRequest 对象中设置 useCache 属性将覆盖此默认设置。此设置不适用于文件上载或 RTMP 请求中使用的 URLRequest 对象。
默认值为 true。
实现
public static function get useCache():Boolean public static function set useCache(value:Boolean):void引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。
|
相关 API 元素
userAgent | 属性 |
userAgent:String| 运行时版本: | AIR 1.0, Flash Lite 4 |
URLRequest 对象的 userAgent 属性的默认设置。在 URLRequest 对象中设置 userAgent 属性将覆盖此默认设置。
这也是用于所有 HTMLLoader 对象（调用 HTMLLoader 对象的 load() 方法时使用）的默认用户代理字符串。设置 HTMLLoader 对象的 userAgent 属性将覆盖 URLRequestDefaults.userAgent 设置。
此默认值随着运行时操作系统（如 Mac OS、Linux 或 Windows）、运行时语言和运行时版本而变化，如下面的示例所示：
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5""Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5""Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
实现
public static function get userAgent():String public static function set userAgent(value:String):void引发
SecurityError — 调用方不在 AIR 应用程序安全沙箱中。
|
相关 API 元素
setLoginCredentialsForHost | () | 方法 |
public static function setLoginCredentialsForHost(hostname:String, user:String, password:String):*| 运行时版本: | AIR 1.0, Flash Lite 4 |
为选定的主机设置默认用户和密码凭据。这些设置适用于应用程序的所有应用程序域中的 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 应用程序安全沙箱中。
|
Tue Jun 12 2018, 11:04 AM Z