addRequestHeader (LoadVars.addRequestHeader メソッド)

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

POST アクションによって送信される HTTP リクエストヘッダー (Content-Type や SOAPAction など) を追加または変更します。シンタックス 1 では、2 つのストリングをメソッドに渡します。header と headerValue です。シンタックス 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 (LoadVars.addRequestHeader メソッド)

パラメータ

例

関連項目