| パッケージ | flash.net |
| クラス | public class URLRequestDefaults |
| 継承 | URLRequestDefaults  Object |
| ランタイムバージョン: | AIR 1.0, Flash Lite 4 |
URLRequestDefaults.setLoginCredentialsForHost() も含まれています。このメソッドを使用すると、要求のデフォルトの認証資格情報を定義できます。URLRequest クラスは、HTTP 要求で使用される情報を定義します。
URLRequest オブジェクトで設定されるプロパティは、URLRequestDefaults クラスに対し設定される静的プロパティをオーバーライドします。
URLRequestDefault の設定は、呼び出し側のアプリケーションドメイン内にあるコンテンツにのみ適用されますが、1 つ例外があります。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 オブジェクトの load() メソッドを呼び出すと使用される) すべての HTMLLoader オブジェクトのデフォルトのユーザーエージェントストリングでもあります。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, 10:34 AM Z