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

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

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

次のリクエストヘッダは使用できません。また、制限対象の項では大文字と小文字が区別されません (たとえば、GetgetGET はすべて禁止されています)。また、アンダースコア文字が使用されている場合は、ハイフンのある項が該当します (たとえば、Content-LengthContent_Length は共に禁止されています)。

Accept-CharsetAccept-EncodingAccept-RangesAgeAllowAllowedAuthorizationCharge-ToConnectConnectionContent-LengthContent-LocationContent-RangeCookieDateDeleteETagExpectGetHeadHostKeep-AliveLast-ModifiedLocationMax-ForwardsOptionsPostProxy-AuthenticateProxy-AuthorizationProxy-ConnectionPublicPutRangeRefererRequest-RangeRetry-AfterServerTETraceTrailerTransfer-EncodingUpgradeURIUser-AgentVaryViaWarningWWW-Authenticatex-flash-version

URLRequestHeader オブジェクトの長さは制限されています。URLRequestHeader オブジェクトの累積長 (name プロパティの長さに value プロパティの長さを足したもの) または URLRequest.requestHeaders プロパティで使用する URLRequestHeader オブジェクトの配列が許容長を超えると、Adobe® Flash® Player により例外がスローされます。

例を表示

関連項目

URLRequest
URLLoader


パブリック プロパティ
 プロパティ定義元
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  name : String
HTTP リクエストヘッダ名 (Content-Type や SOAPAction など) です。
URLRequestHeader
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
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
Player のバージョン : Flash Player 9

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

valueプロパティ 
public var value:String

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9

name プロパティに関連付けられた値 (text/plain など) です。

コンストラクタの詳細
URLRequestHeader()コンストラクタ
public function URLRequestHeader(name:String = "", value:String = "")

言語バージョン : ActionScript 3.0
Player のバージョン : 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/flash/9.0_jp/ActionScriptLangRefV3/flash/net/URLRequestHeader.html