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 に関連付けられた値を表すストリング。

例

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

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

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

var headers:Array = new Array("Content-Type", "text/plain", 
"X-ClientAppVersion", "2.0");
my_xml.addRequestHeader(headers);

関連項目

addRequestHeader (LoadVars.addRequestHeader メソッド)