flash.net.URLRequest (Flex™ 2 リファレンスガイド)

	プロパティ	定義
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		contentType : String 任意の `POST` データの MIME コンテンツタイプです。	URLRequest
		data : Object URL リクエストで送信されるデータを含むオブジェクトです。	URLRequest
		method : String HTTP フォーム送信メソッドが `GET` または `POST` のどちらの操作であるかを制御します。	URLRequest
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		requestHeaders : Array HTTP リクエストヘッダーの配列が HTTP リクエストに追加されます。	URLRequest
		url : String リクエストされる URL です。	URLRequest

	メソッド	定義
		URLRequest(url:String = null) URLRequest オブジェクトを作成します。	URLRequest
		hasOwnProperty(name:String):Boolean 指定されたプロパティがオブジェクトに定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object

プロパティの詳細

contentType

プロパティ

contentType:String [read-write]

任意の POST データの MIME コンテンツタイプです。

メモ : FileReference.upload() メソッドおよび FileReference.download() メソッドでは URLRequest.contentType パラメータをサポートしていません。

実装
public function get contentType():String
public function set contentType(value:String):void

data

プロパティ

data:Object [read-write]

URL リクエストで送信されるデータを含むオブジェクトです。

このプロパティは method プロパティと一緒に使用します。URLRequest.method の値が POST の場合、データは HTTP POST メソッドで URLRequest オブジェクトによって転送されます。

URLRequest.method の値が GET の場合、データは HTTP GET メソッドで URLRequest オブジェクトによって送信される変数を定義します。

URLRequest API は、ストリング以外に、バイナリ POST と URL エンコード変数もサポートします。データオブジェクト型には、ByteArray、URLVariables、または String を指定できます。

データが使用される方法は、使用されるオブジェクトの型によって異なります。

オブジェクトが ByteArray オブジェクトの場合、ByteArray オブジェクトのバイナリデータは POST データとして使用されます。GET の場合、ByteArray 型のデータはサポートされません。さらに、FileReference.upload() および FileReference.download() で ByteArray 型のデータはサポートされません。
オブジェクトが URLVariables オブジェクトで、メソッドが POST の場合、変数は x-www-form-urlencoded 形式を使用してエンコードされ、結果のストリングが POST データとして使用されます。例外は FileReference.upload() の呼び出しです。この場合、変数は、multipart/form-data ポストの個別のフィールドとして送信されます。
オブジェクトが URLVariables オブジェクトで、メソッドが GET の場合、URLVariables オブジェクトは URLRequest オブジェクトによって送信される変数を定義します。
それ以外の場合、オブジェクトはストリングに変換され、そのストリングが POST または GET データとして使用されます。

このデータは、navigateToURL() や FileReference.upload() などのメソッドで URLRequest オブジェクトが使用されるまで送信されません。

実装
public function get data():Object
public function set data(value:Object):void

method

プロパティ

method:String [read-write]

HTTP フォーム送信メソッドが GET または POST のどちらの操作であるかを制御します。有効な値は、URLRequestMethod.GET または URLRequestMethod.POST です。

デフォルト値URLRequestMethod.GET.

実装
public function get method():String
public function set method(value:String):void

Throws

ArgumentError — value パラメータが URLRequestMethod.GET でも URLRequestMethod.POST でもない場合。

関連項目

URLRequestMethod class
外部データの操作

requestHeaders

プロパティ

requestHeaders:Array [read-write]

HTTP リクエストヘッダーの配列が HTTP リクエストに追加されます。配列は URLRequestHeader オブジェクトから構成されます。配列の各オブジェクトは、次のように名前ストリングと値ストリングを含む URLRequestHeader オブジェクトである必要があります。

  var rhArray:Array = new Array(new URLRequestHeader("Content-Type", "text/html"));

Flash Player ではリクエストヘッダーに対して一定の制限が設定されています。詳細については、URLRequestHeader クラスの説明を参照してください。

FileReference.upload() および FileReference.download() メソッドは URLRequest.requestHeaders パラメータをサポートしていません。

実装
public function get requestHeaders():Array
public function set requestHeaders(value:Array):void

関連項目

URLRequestHeader

url

プロパティ

url:String [read-write]

リクエストされる URL です。デフォルトで、URL はサブドメインを含めて呼び出し元の SWF ファイルと同じドメインに置かれている必要があります。たとえば、www.adobe.com と store.adobe.com にある SWF ファイルは異なるドメインにあります。異なるドメインからデータをロードするには、SWF ファイルをホストするサーバーにクロスドメインポリシーファイルを配置します。詳細については、URLRequest クラスの説明のセキュリティに関する説明を参照してください。

実装
public function get url():String
public function set url(value:String):void

コンストラクタの詳細

URLRequest

()

コンストラクタ

public 関数 URLRequest(url:String = null)

URLRequest オブジェクトを作成します。System.useCodePage が true の場合、リクエストは Unicode ではなく、システムのコードページを使ってエンコードされます。System.useCodePage が false の場合、リクエストはシステムのコードページではなく、Unicode を使ってエンコードされます。

パラメータ

url:String (default = null) — リクエストされる URL です。url プロパティを使用して、URL を後から設定できます。

関連項目

flash.system.System.useCodePage

Adobe^® Flex™ 2 リファレンスガイド		すべてのパッケージ \| すべてのクラス \| \| 索引 \| 付録 \| 規則 \| フレーム内に表示フレームなしバージョン
Class URLRequest	プロパティ \| メソッド

パッケージ	flash.net
	public final class URLRequest
継承	URLRequest Object