public addRequestHeader(header:Object, headerValue:String) : Void

POST アクションによって送信される HTTP リクエストヘッダー (Content-Type や SOAPAction など) を追加または変更します。シンタックス 1 では、header および headerValue の 2 つのストリングをメソッドに渡します。シンタックス 2 では、ヘッダー名とヘッダー値を交互に含むストリングの配列を渡します。

同じヘッダー名に対して複数の呼び出しを実行すると、呼び出しのたびに前の呼び出しで設定された値が上書きされます。

このメソッドを使用して、標準の HTTP ヘッダー (Accept-Ranges、Age、Allow、Allowed、Connection、Content-Length、Content-Location、Content-Range、ETag、Host、Last-Modified、Locations、Max-Forwards、Proxy-Authenticate、Proxy-Authorization、Public、Range、Retry-After、Server、TE、Trailer、Transfer-Encoding、Upgrade、URI、Vary、Via、Warning、および WWW-Authenticate) を追加または変更することはできません。

パラメータ

header:Object - HTTP リクエストヘッダー名を表すストリング、またはストリングの配列。

headerValue:String - header に関連付けられた値を表すストリング。

例

次の例では、値が Foo である SOAPAction というカスタム HTTP ヘッダーを my_lv オブジェクトに追加します。

my_lv.addRequestHeader("SOAPAction", "'Foo'");

次の例では、headers という配列を作成します。この配列には、HTTP ヘッダーとその値が交互に格納されます。この配列を addRequestHeader() に引数として渡します。

var headers = ["Content-Type", "text/plain", "X-ClientAppVersion", "2.0"];
my_lv.addRequestHeader(headers);

次の例では、FLASH-UUID というリクエストヘッダーを追加する新しい LoadVars オブジェクトを作成します。ヘッダーには変数が格納され、サーバー側でチェックできます。

var my_lv:LoadVars = new LoadVars();
my_lv.addRequestHeader("FLASH-UUID", "41472");
my_lv.name = "Mort";
my_lv.age = 26;
my_lv.send("http://flash-mx.com/mm/cgivars.cfm", "_blank", "POST");

関連項目

addRequestHeader (XML.addRequestHeader メソッド)