XML.addRequestHeader()

可用性

Flash Player 6。

用法

xml.addRequestHeader(headerName, headerValue)
xml.addRequestHeader(["headerName_1", "headerValue_1" ..."headerName_n", "headerValue_n"])

参数

headerName HTTP 请求标头名称。

headerValue 与 headerName 关联的值。

返回

无。

说明

方法，添加或更改用 POST 动作发送的 HTTP 请求标头（如 Content-Type 或 SOAPAction）。在第一种用法中，向该方法传递了两个字符串：headerName 和 headerValue。在第二种用法中，传递了字符串、替代标头名称和标头值的数组。

如果通过多次调用来设置相同的标头名称，则每个后继值将替换在上一次调用中设置的值。

您不能使用此方法添加或更改下列标准 HTTP 标头：Accept-Ranges、Age、Allow、Allowed、
Connection、Content-Length、Content-Location、Content-Range、ETag、Host、Last-
Modified、Locations、Max-Forwards、Proxy-Authenticate、Proxy-Authorization、Public、Range、Retry-After、Server、TE、Trailer、Transfer-Encoding、Upgrade、URI、Vary、Via、Warning 和 WWW-Authenticate。

示例

以下示例将值为 Foo 的自定义 HTTP 标头 SOAPAction 添加到名为 my_xml 的 XML 对象中。

my_xml.addRequestHeader("SOAPAction", "'Foo'");

下一个示例创建名为 headers 的数组，它包含两个替代 HTTP 标头及其关联值。然后将该数组作为参数传递给 addRequestHeader() 方法。

var headers = ["Content-Type", "text/plain", "X-ClientAppVersion", "2.0"];
my_xml.addRequestHeader(headers);

另请参见

LoadVars.addRequestHeader()