| Pacchetto | flash.net |
| Classe | public final class URLRequestHeader |
| Ereditarietà | URLRequestHeader  Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
requestHeaders della classe URLRequest.
In Adobe® AIR®, il contenuto presente nella sandbox di sicurezza dell'applicazione (ad esempio, il contenuto installato con l'applicazione AIR) può utilizzare qualunque intestazione di richiesta, senza errore. Tuttavia, per il contenuto in esecuzione in Adobe AIR che si trova in una funzione di sicurezza sandbox diversa, o per il contenuto in esecuzione in Flash® Player, l'uso delle seguenti intestazioni di richiesta può provocare un errore di runtime, e per i termini con restrizioni d'uso non viene fatta distinzione tra maiuscole e minuscole (ad esempio, Get, get e GET non sono consentiti):
Nel contenuto Flash Player e Adobe AIR al di fuori della funzione di sicurezza sandbox dell'applicazione, non è possibile utilizzare le seguenti intestazioni di richiesta e per i termini con restrizioni d'uso non viene fatta distinzione tra maiuscole e minuscole (ad esempio, Get, gete GET non sono consentiti). Inoltre, se viene utilizzato un carattere trattino basso, sono valide anche parole con trattino (per esempio, sia Content-Length che Content_Length non sono consentiti):
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.
Gli oggetti URLRequestHeader hanno una lunghezza limitata. Se la lunghezza cumulativa di un oggetto URLRequestHeader (la lunghezza della proprietà name più la proprietà value) o di un array di oggetti URLRequestHeader utilizzato nella proprietà URLRequest.requestHeaders supera la lunghezza accettabile, viene generata un'eccezione.
Il contenuto in esecuzione in Adobe AIR imposta l'intestazione ACCEPT nel modo seguente, a meno che non specifichiate un'impostazione per l'intestazione ACCEPT nella proprietà requestHeaders della 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
Non tutti i metodi che accettano parametri URLRequest supportano la proprietà requestHeaders; consultate la documentazione relativa al metodo chiamato. I metodi FileReference.upload() eFileReference.download(), ad esempio, non supportano la proprietà URLRequest.requestHeaders.
A causa delle limitazioni del browser, le intestazioni delle richieste HTTP personalizzate sono supportate solo per le richieste POST e non per le richieste GET.
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| name : String
Il nome di un'intestazione di richiesta HTTP (ad esempio, Content-Type o SOAPAction). | URLRequestHeader | ||
| value : String
Il valore associato alla proprietà name (ad esempio, text/plain). | URLRequestHeader | ||
| Metodo | Definito da | ||
|---|---|---|---|
Crea un nuovo oggetto URLRequestHeader che incorpora un'intestazione di richiesta HTTP singola. | URLRequestHeader | ||
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
name | proprietà |
public var name:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Il nome di un'intestazione di richiesta HTTP (ad esempio, Content-Type o SOAPAction).
value | proprietà |
public var value:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Il valore associato alla proprietà name (ad esempio, text/plain).
URLRequestHeader | () | Funzione di costruzione |
public function URLRequestHeader(name:String = "", value:String = "")| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un nuovo oggetto URLRequestHeader che incorpora un'intestazione di richiesta HTTP singola. Gli oggetti URLRequestHeader vengono utilizzati nella proprietà requestHeaders della classe URLRequest.
name:String (default = "Content-Type o SOAPAction).
| |
value:String (default = "name (ad esempio, text/plain).
|
header all'array per la proprietà requestHeaders. L'intestazione indica che l'applicazione dovrebbe inoltrare la richiesta al server di origine anche se dispone di una copia memorizzata nella cache di ciò che viene richiesto.
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);
}
}
}
Tue Jun 12 2018, 02:44 PM Z