| パッケージ | flash.net |
| クラス | public final class URLRequestHeader |
| 継承 | URLRequestHeader Object |
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
requestHeaders プロパティで使用されます。
Adobe® AIR では、アプリケーションセキュリティサンドボックス内のコンテンツ (AIR アプリケーションと共にインストールされたコンテンツなど) は、どのようなリクエストヘッダでもエラーなしで使用できます。ただし、異なるセキュリティサンドボックス内の、Adobe AIR で実行されているコンテンツ で実行されているコンテンツでは、次のリクエストヘッダを使用するとランタイムエラーがスローされます。これらの制限対象の項では大文字と小文字は区別されません(例えば、Get、get、GET はすべて使用できません)。
Flash Player およびアプリケーションセキュリティサンドボックス外の Adobe AIR コンテンツでは、次のリクエストヘッダを使用できません。これらの制限対象の項では大文字と小文字は区別されません(例えば、Get、get、GET はすべて使用できません)。また、アンダースコア文字が使用されている場合は、ハイフンのある項が該当します(たとえば、Content-Length と Content_Length は共に禁止されています)。
Accept-Charset, Accept-Encoding, Accept-Ranges, Age, Allow, Allowed, Authorization, Charge-To, Connect, Connection, Content-Length, Content-Location, Content-Range, Cookie, Date, Delete, ETag, Expect, Get, Head, Host, Keep-Alive, Last-Modified, Location, Max-Forwards, Options, Origin, Post, Proxy-Authenticate, Proxy-Authorization, Proxy-Connection, Public, Put, Range, Referer, Request-Range, Retry-After, Server, TE, Trace, Trailer, Transfer-Encoding, Upgrade, URI, User-Agent, Vary, Via, Warning, WWW-Authenticate, x-flash-version.
URLRequestHeader オブジェクトの長さは制限されています。URLRequestHeader オブジェクトの累積長(name プロパティの長さに value プロパティの長さを足したもの)または URLRequest.requestHeaders プロパティで使用する URLRequestHeader オブジェクトの配列が許容長を超えると、例外がスローされます。
Adobe AIR で実行されているコンテンツでは、ACCEPT ヘッダに以下を設定します。ただし、URLRequest クラスの ACCEPT ヘッダ (requestHeaders プロパティ) に設定を指定している場合は除きます。
text/xml,
application/xml,
application/xhtml+xml,
text/html;q=0.9,
text/plain;q=0.8,
image/png,
application/x-shockwave-flash,
video/mp4;q=0.9,
flv-application/octet-stream;q=0.8,
video/x-flv;q=0.7,
audio/mp4,
*/*;q=0.5
URLRequest パラメータを受け取るメッソドすべてが requestHeaders プロパティをサポートしているわけではありません。呼び出すメソッドのマニュアルを参照してください。例えば、FileReference.upload() メソッドおよび FileReference.download() メソッドは、URLRequest.requestHeaders プロパティをサポートしていません。
ブラウザの制限により、カスタム HTTP リクエストヘッダは POST リクエストだけをサポートし、GET リクエストはサポートしません。
関連項目
| プロパティ | 定義元 | ||
|---|---|---|---|
![]() | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。 | Object | |
| name : String
HTTP リクエストヘッダ名 (Content-Type や SOAPAction など) です。 | URLRequestHeader | ||
![]() | prototype : Object [静的]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。 | Object | |
| value : String
name プロパティに関連付けられた値 (text/plain など) です。 | URLRequestHeader | ||
| メソッド | 定義元 | ||
|---|---|---|---|
1 つの HTTP リクエストヘッダをカプセル化する新しい URLRequestHeader オブジェクトを作成します。 | URLRequestHeader | ||
![]() |
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
![]() |
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
![]() |
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
![]() |
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
![]() |
指定されたオブジェクトのストリング表現を返します。 | Object | |
![]() |
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
| name | プロパティ |
public var name:String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
HTTP リクエストヘッダ名(Content-Type や SOAPAction など)です。
| value | プロパティ |
public var value:String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
name プロパティに関連付けられた値(text/plain など)です。
| URLRequestHeader | () | コンストラクタ |
public function URLRequestHeader(name:String = "", value:String = "")| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
1 つの HTTP リクエストヘッダをカプセル化する新しい URLRequestHeader オブジェクトを作成します。URLRequestHeader オブジェクトは URLRequest クラスの requestHeaders プロパティで使用されます。
name:String (default = "") — HTTP リクエストヘッダ名(Content-Type や SOAPAction など)です。
| |
value:String (default = "") — name プロパティに関連付けられた値(text/plain など)です。
|
header を、requestHeaders プロパティの配列に追加します。ヘッダは、要求されたものがキャッシュされていても、アプリケーションから元のサーバーに要求を転送する必要があることを示します。
package {
import flash.display.Sprite;
import flash.events.*;
import flash.net.URLLoader;
import flash.net.URLRequest;
import flash.net.URLRequestHeader;
import flash.net.URLRequestMethod;
import flash.net.URLVariables;
public class URLRequestHeaderExample extends Sprite {
public function URLRequestHeaderExample() {
var loader:URLLoader = new URLLoader();
configureListeners(loader);
var header:URLRequestHeader = new URLRequestHeader("pragma", "no-cache");
var request:URLRequest = new URLRequest("http://www.[yourdomain].com/greeting.cfm");
request.data = new URLVariables("name=John+Doe");
request.method = URLRequestMethod.POST;
request.requestHeaders.push(header);
try {
loader.load(request);
} catch (error:Error) {
trace("Unable to load requested document.");
}
}
private function configureListeners(dispatcher:IEventDispatcher):void {
dispatcher.addEventListener(Event.COMPLETE, completeHandler);
dispatcher.addEventListener(Event.OPEN, openHandler);
dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
}
private function completeHandler(event:Event):void {
var loader:URLLoader = URLLoader(event.target);
trace("completeHandler: " + loader.data);
}
private function openHandler(event:Event):void {
trace("openHandler: " + event);
}
private function progressHandler(event:ProgressEvent):void {
trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
}
private function securityErrorHandler(event:SecurityErrorEvent):void {
trace("securityErrorHandler: " + event);
}
private function httpStatusHandler(event:HTTPStatusEvent):void {
trace("httpStatusHandler: " + event);
}
private function ioErrorHandler(event:IOErrorEvent):void {
trace("ioErrorHandler: " + event);
}
}
}
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート
現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/flash/net/URLRequestHeader.html