window.runtime 属性window.runtime.flash.net.URLRequestHeader
继承URLRequestHeader Inheritance Object

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

在 Adobe® AIR 中,应用程序安全沙箱中的内容(如使用 AIR 应用程序安装的内容)可以使用任何请求标头而不会出错。不过,对于在 Adobe AIR 中运行的不同安全沙箱中的内容,使用以下请求标头将会引发运行时错误,且限制的术语不区分大小写(例如,GetgetGET 均不得使用):

在应用程序安全沙箱以外的 Flash Player 和 Adobe AIR 内容中,不能使用以下请求标头,且限制的术语不区分大小写(例如,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 对象数组超过可接受的长度,则应用程序将引发异常。

除非为 URLRequest 类的 requestHeaders 属性中的 ACCEPT 标头指定设置,否则,在 Adobe AIR 中运行的内容会将 ACCEPT 标头设置为以下值:

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
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 = "")
创建一个封装单个 HTTP 请求标头的新 URLRequestHeader 对象。
URLRequestHeader
 Inherited
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
 Inherited
toString():String
返回指定对象的字符串表示形式。
Object
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
属性详细信息
name属性
var name:String

HTTP 请求标头名称(如 Content-TypeSOAPAction)。

value属性 
var value:String

name 属性相关联的值(如 text/plain)。

构造函数详细信息
URLRequestHeader()构造函数
function URLRequestHeader(name:String = "", value:String = "")

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

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