| Package | flash.net |
| Classe | public final class URLRequestHeader |
| Héritage | URLRequestHeader  Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
requestHeaders de la classe URLRequest.
Dans Adobe® AIR®, le contenu du sandbox de sécurité de l’application (par exemple, le contenu installé avec l’application AIR) peut utiliser n’importe quel en-tête de requête, sans qu’aucune erreur ne se produise. En revanche, dans le cas de contenu s’exécutant dans Adobe AIR et se trouvant dans un sandbox de sécurité différent ou dans le cas de contenu s’exécutant dans Flash® Player, l’utilisation de ces en-têtes de requête entraîne le renvoi d’une erreur d’exécution ; en outre, les termes restreints ne sont pas sensibles à la casse (par exemple, Get, get et GET ne sont pas tous autorisés) :
Dans le cas de contenu s’exécutant dans Flash Player ou de contenu s’exécutant dans Adobe AIR hors du sandbox de sécurité de l’application, les en-têtes de requête suivants ne peuvent pas être utilisés et les termes restreints ne sont pas sensibles à la casse (par exemple, Get, get et GET ne sont pas tous autorisés). De même, les termes composés s’appliquent lorsqu’un caractère de soulignement est utilisé (par exemple, Content-Length et Content_Length ne sont pas autorisés tous les deux) :
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.
La longueur des objets URLRequestHeader est limitée. Si la longueur totale d’un objet URLRequestHeader (longueur de la propriété name et de la propriété value) ou d’un tableau d’objets URLRequestHeader utilisé dans la propriété URLRequest.requestHeaders est supérieure à la longueur prise en charge, une exception est renvoyée.
Le contenu s’exécutant dans Adobe AIR définit l’en-tête ACCEPT de la façon suivante, à moins que vous ne spécifiez un paramètre pour l’en-tête ACCEPT dans la propriété requestHeaders de la 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
Toutes les méthodes qui acceptent des paramètres URLRequest ne prennent pas en charge la propriété requestHeaders ; consultez la documentation de la méthode que vous appelez. Par exemple, les méthodes FileReference.upload() et FileReference.download() ne prennent pas en charge la propriété URLRequest.requestHeaders.
Du fait des limites des navigateurs, les en-têtes de requête HTTP personnalisées ne sont prises en charge que pour les requêtes POST, pas pour les requêtes GET.
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| name : String
Nom d’en-tête de requête HTTP (tel que Contenu-Type ou SOAPAction). | URLRequestHeader | ||
| value : String
Valeur associée à la propriété name (telle que text/plain). | URLRequestHeader | ||
| Méthode | Défini par | ||
|---|---|---|---|
Crée un objet URLRequestHeader qui encapsule un en-tête de requête HTTP unique. | URLRequestHeader | ||
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
name | propriété |
public var name:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Nom d’en-tête de requête HTTP (Content-Type ou SOAPAction, par exemple).
value | propriété |
public var value:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Valeur associée à la propriété name (text/plain, par exemple).
URLRequestHeader | () | Constructeur |
public function URLRequestHeader(name:String = "", value:String = "")| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crée un objet URLRequestHeader qui encapsule un en-tête de requête HTTP unique. Les objets URLRequestHeader sont utilisés dans la propriété requestHeaders de la classe URLRequest.
name:String (default = "Content-Type ou SOAPAction, par exemple).
| |
value:String (default = "name (text/plain, par exemple).
|
header au tableau de la propriété requestHeaders. L’en-tête indique que l’application doit transférer la requête au serveur d’origine, même si elle en possède une copie mise en cache.
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, 09:30 AM Z