LoadVars.addRequestHeader()

Disponibilidad

Flash Player 6.

Sintaxis

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

Parámetros

headerName Nombre de encabezado de una solicitud HTTP.

headerValue Valor asociado con headerName.

Valor devuelto

Ninguno.

Descripción

Método; añade o cambia encabezados de solicitud HTTP (tales como Content-Type o SOAPAction) enviados con acciones POST. En la primera sintaxis, se pasan dos cadenas al método: headerName y headerValue. En la segunda sintaxis, se pasa una matriz de cadenas, en las que se alternan los nombres y los valores de encabezado.

Si se realizan varias llamadas para establecer el mismo nombre de encabezado, cada valor sucesivo sustituirá el valor establecido en la llamada anterior.

Con este método no se pueden añadir ni cambiar los encabezados HTTP estándar siguientes: 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 y WWW-Authenticate.

Ejemplo

En este ejemplo se añade un encabezado HTTP personalizado denominado SOAPAction con el valor Foo al objeto my_lv.

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

En el ejemplo siguiente, se crea una matriz denominada headers que contiene dos encabezados HTTP alternos y los valores asociados correspondientes. La matriz se pasa como un argumento a addRequestHeader().

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

Véase también

XML.addRequestHeader()