URLRequestDefaults - Adobe ActionScript® 3（AS3 ）API リファレンス

パッケージ	flash.net
クラス	public class URLRequestDefaults
継承	URLRequestDefaults Object

ランタイムバージョン:

AIR 1.0, Flash Lite 4

URLRequestDefaults クラスには、URLRequest クラスのプロパティのデフォルト値を定義するために設定できる静的プロパティが含まれています。また、静的メソッドの URLRequestDefaults.setLoginCredentialsForHost() も含まれています。このメソッドを使用すると、要求のデフォルトの認証資格情報を定義できます。URLRequest クラスは、HTTP 要求で使用される情報を定義します。

URLRequest オブジェクトで設定されるプロパティは、URLRequestDefaults クラスに対し設定される静的プロパティをオーバーライドします。

URLRequestDefault の設定は、呼び出し側のアプリケーションドメイン内にあるコンテンツにのみ適用されますが、1 つ例外があります。URLRequestDefaults.setLoginCredentialsForHost() を呼び出して行われる設定は、現在実行中のアプリケーションのすべてのアプリケーションドメインに適用されます。

アプリケーションセキュリティサンドボックスで実行される Adobe^® AIR^® コンテンツだけが URLRequestDefaults クラスを使用できます。他のコンテンツがこのクラスのメンバーまたはプロパティにアクセスすると、SecurityError がスローされます。

関連する API エレメント

URLRequest

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		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

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		setLoginCredentialsForHost(hostname:String, user:String, password:String):* [静的] 選択したホストのデフォルトユーザーおよびパスワード情報を設定します。	URLRequestDefaults
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():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 エレメント

URLRequest.authenticate

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 エレメント

URLRequest.cacheResponse

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 エレメント

URLRequest.followRedirects

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 が負の値です。

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 エレメント

URLRequest.manageCookies

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 エレメント

URLRequest.useCache

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 アプリケーションセキュリティサンドボックス内に存在しません。

メソッドの詳細

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 アプリケーションセキュリティサンドボックス内に存在しません。

法律上の注意 | プライバシーポリシー

URLRequestDefaults - AS3

パッケージx

言語エレメント

付録

パッケージ flash.net

authenticate

cacheResponse

followRedirects

idleTimeout

manageCookies

useCache

userAgent

setLoginCredentialsForHost