| 套件 | 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 類別的靜態屬性只會套用至呼叫者的應用程式網域)。如此一來，在應用程式的另一個部分登入時，整個應用程式的內容都可以登入 (不論內容的應用程式網域為何)。
在 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, 03:47 PM Z