パッケージflash.net
クラスpublic final class URLRequestHeader
継承URLRequestHeader Inheritance Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

URLRequestHeader オブジェクトは 1 つの HTTP のリクエストヘッダをカプセル化し、名前と値のペアを構成します。URLRequestHeader オブジェクトは URLRequest クラスの requestHeaders プロパティで使用されます。

Adobe® AIR では、アプリケーションセキュリティサンドボックス内のコンテンツ (AIR アプリケーションと共にインストールされたコンテンツなど) は、どのようなリクエストヘッダでもエラーなしで使用できます。ただし、異なるセキュリティサンドボックス内の、Adobe AIR で実行されているコンテンツ で実行されているコンテンツでは、次のリクエストヘッダを使用するとランタイムエラーがスローされます。これらの制限対象の項では大文字と小文字は区別されません(例えば、GetgetGET はすべて使用できません)。

Flash Player およびアプリケーションセキュリティサンドボックス外の Adobe AIR コンテンツでは、次のリクエストヘッダを使用できません。これらの制限対象の項では大文字と小文字は区別されません(例えば、GetgetGET はすべて使用できません)。また、アンダースコア文字が使用されている場合は、ハイフンのある項が該当します(たとえば、Content-LengthContent_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 リクエストはサポートしません。

例を表示

関連項目

URLRequest
URLLoader


パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  name : String
HTTP リクエストヘッダ名 (Content-Type や SOAPAction など) です。
URLRequestHeader
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  value : String
name プロパティに関連付けられた値 (text/plain など) です。
URLRequestHeader
パブリックメソッド
 メソッド定義元
  
URLRequestHeader(name:String = "", value:String = "")
1 つの HTTP リクエストヘッダをカプセル化する新しい URLRequestHeader オブジェクトを作成します。
URLRequestHeader
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
プロパティの詳細
nameプロパティ
public var name:String

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

HTTP リクエストヘッダ名(Content-TypeSOAPAction など)です。

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-TypeSOAPAction など)です。
 
value:String (default = "")name プロパティに関連付けられた値(text/plain など)です。
例の使用法
URLRequestHeaderExample.as

次の例では、単一の HTTP リクエストヘッダ 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