flash.net
public final class URLRequestHeader
继承URLRequestHeader Inheritance Object

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9

URLRequestHeader 对象封装了一个 HTTP 请求标头并由一个名称/值对组成。 URLRequestHeader 对象在 URLRequest 类的 requestHeaders 属性中使用。

无法使用下列请求标头,并且受限制的词不区分大小写(例如,GetgetGET 都不允许使用):

Accept-Charset, Accept-Encoding, Accept-Ranges, Age, Allow, Allowed, Connection, Content-Length, Content-Location, Content-Range, Date, Delete, ETag, Expect, Get, Host, Keep-Alive, Last-Modified, Location, Max-Forwards, Options, Post, Proxy-Authenticate, Proxy-Authorization, Public, Put, Range, Referer, 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 ® 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 = "")
创建一个封装单个 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

创建一个封装单个 HTTP 请求标头的新 URLRequestHeader 对象。 URLRequestHeader 对象在 URLRequest 类的 requestHeaders 属性中使用。

参数
name:String (default = "") — HTTP 请求标头名称(如 Content-TypeSOAPAction)。
 
value:String (default = "") — 与 name 属性相关联的值(如 text/plain)。
示例 如何使用示例

下例将 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_cn/ActionScriptLangRefV3/flash/net/URLRequestHeader.html