| Pacote | flash.net |
| Classe | public final class URLRequestHeader |
| Herança | URLRequestHeader  Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
requestHeaders da classe URLRequest.
No Adobe ®AIR®, o conteúdo na área de segurança do aplicativo (assim como o conteúdo instalado com o aplicativo AIR) pode usar qualquer cabeçalho de solicitação, sem erros. Contudo, para um conteúdo em execução no Adobe AIR em uma área de segurança diferente ou para o conteúdo em execução no Flash® Player, o uso dos cabeçalhos de solicitação a seguir causam um erro de tempo de execução a ser jogado, e os termos de restrição não diferenciam maiúsculas de minúsculas (por exemplo, Get, get e GET não são permitidos):
No conteúdo do Flash Player e do Adobe AIR fora da área de segurança do aplicativo, os cabeçalhos de solicitação a seguir não podem ser usados e os termos de restrição não diferenciam maiúsculas de minúsculas (por exemplo, Get, get e GET não são permitidos). Além disso, termos separados por hífen apenas serão aplicáveis se um caractere de sublinhado for usado (por exemplo, Content-Length e Content_Length não são permitidos):
Accept-Charset, Accept-Encoding, Accept-Ranges, Age, Allow, Allowed, Authorization, Charge-To, Connect, Connection, Content-Length, Content-Location, Content-Range, Cookie, Date, Delete, ETag, Expect, Get, Head, Host, If-Modified-Since, Keep-Alive, Last-Modified, Location, Max-Forwards, Options, Origin, Post, Proxy-Authenticate, Proxy-Authorization, Proxy-Connection, Public, Put, Range, Referer, Request-Range, Retry-After, Server, TE, Trace, Trailer, Transfer-Encoding, Upgrade, URI, User-Agent, Vary, Via, Warning, WWW-Authenticate, x-flash-version.
Objetos URLRequestHeader têm restrições de comprimento. Se o comprimento cumulativo de um objeto URLRequestHeader (o comprimento da propriedade name mais a propriedade value) ou uma matriz de objetos URLRequestHeader usada na propriedade URLRequest.requestHeaders exceder o comprimento aceitável, uma exceção será lançada.
O conteúdo em execução no Adobe AIR define o cabeçalho ACCEPT ao seguinte, a menos que uma configuração seja especificada para o cabeçalho ACCEPT na propriedade requestHeaders da classe URLRequest:
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
Nem todos os métodos que aceitam parâmetros de URLRequest suportam a propriedade requestHeaders; consulte a documentação para verificar o método que você está chamando. Por exemplo, os métodos FileReference.upload() e FileReference.download() não suportam a propriedade URLRequest.requestHeaders.
Em virtude de limitações do navegador, os cabeçalhos personalizados de solicitação HTTP são suportados somente para solicitações POST, não para solicitações GET.
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| name : String
Um nome de cabeçalho de solicitação HTTP (como Content-Type ou SOAPAction). | URLRequestHeader | ||
| value : String
O valor associado à propriedade de nome (como texto /simples). | URLRequestHeader | ||
| Método | Definido por | ||
|---|---|---|---|
Cria um novo objeto URLRequestHeader que encapsula um único cabeçalho de solicitação HTTP. | URLRequestHeader | ||
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
name | propriedade |
public var name:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um nome de cabeçalho de solicitação HTTP (como Content-Type ou SOAPAction).
value | propriedade |
public var value:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O valor associado à propriedade name (como text/plain).
URLRequestHeader | () | Construtor |
public function URLRequestHeader(name:String = "", value:String = "")| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria um novo objeto URLRequestHeader que encapsula um único cabeçalho de solicitação HTTP. Objetos URLRequestHeader são usados na propriedade requestHeaders da classe URLRequest.
name:String (default = "Content-Type ou SOAPAction).
| |
value:String (default = "name (como text/plain).
|
header à matriz da propriedade requestHeaders. O cabeçalho indica que o aplicativo deve encaminhar a solicitação ao servidor de origem, mesmo que ele tenha uma cópia armazenada em cache do quê está sendo solicitado.
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 {
private var loader:URLLoader;
public function URLRequestHeaderExample() {
loader = 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);
}
}
}
Wed Jun 13 2018, 11:10 AM Z