| Pakket | flash.net |
| Klasse | public final class URLRequestHeader |
| Overerving | URLRequestHeader  Object |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
requestHeaders van de klasse URLRequest.
In Adobe® AIR® kan inhoud in de sandbox met toepassingsbeveiliging (zoals inhoud die met de AIR-toepassing is geïnstalleerd), probleemloos alle aanvraagheaders gebruiken. Voor inhoud die in Adobe AIR wordt uitgevoerd en zich in een andere beveiligingssandbox bevindt of voor inhoud die wordt uitgevoerd in Flash® Player, kan het gebruik van de volgende aanvraagheaders een runtime-fout tot gevolg hebben. De elementen van de beperking zijn niet hoofdlettergevoelig (Get, get en GET zijn bijvoorbeeld allemaal niet toegestaan):
In inhoud in Flash Player en Adobe AIR buiten de sandbox met toepassingsbeveiliging kunnen de volgende aanvraagheaders niet worden gebruikt. De elementen van de beperking zijn hoofdlettergevoelig (Get, get en GET zijn allemaal niet toegestaan.). Bovendien zijn termen met een koppelteken van toepassing wanneer een onderstrepingsteken wordt gebruikt (zowel Content-Length als Content_Length zijn bijvoorbeeld niet toegestaan):
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.
Objecten URLRequestHeader zijn beperkt in lengte. Wanneer de cumulatieve lengte van een object URLRequestHeader (de lengte van de eigenschappen name plus value) of een array van objecten URLRequestHeader in de eigenschap URLRequest.requestHeaders de toegestane lengte overschrijdt, wordt een uitzondering gegenereerd.
Inhoud die wordt uitgevoerd in Adobe AIR stelt de header ACCEPT in op het volgende, tenzij u een instelling voor de header ACCEPT opgeeft in de eigenschap requestHeaders van de klasse 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
Niet alle methoden die URLRequest-parameters accepteren ondersteunen de eigenschap requestHeaders. Raadpleeg de documentatie voor de methode die u wilt aanroepen. De methoden FileReference.upload() en FileReference.download() onderstenen de eigenschap URLRequest.requestHeaders bijvoorbeeld niet.
Vanwege beperkingen van de browser worden aangepaste HTTP-requestheaders alleen ondersteund voor POST-aanvragen, niet voor GET-aanvragen.
Verwante API-elementen
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
 | constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | |
| name : String
Een HTTP-aanvraagheadernaam (zoals Content-Type of SOAPAction). | URLRequestHeader | ||
| value : String
De waarde die aan de eigenschap name (zoals text/plain) is gekoppeld. | URLRequestHeader | ||
| Methode | Gedefinieerd door | ||
|---|---|---|---|
Maakt een nieuw object URLRequestHeader dat een enkele HTTP-aanvraagheader inkapselt. | URLRequestHeader | ||
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
|
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | |
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
name | eigenschap |
public var name:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een HTTP-aanvraagheadernaam (zoals Content-Type of SOAPAction).
value | eigenschap |
public var value:String| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De waarde die aan de eigenschap name (zoals text/plain) is gekoppeld.
URLRequestHeader | () | Constructor |
public function URLRequestHeader(name:String = "", value:String = "")| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Maakt een nieuw object URLRequestHeader dat een enkele HTTP-aanvraagheader inkapselt. Objecten URLRequestHeader worden gebruikt in de eigenschap requestHeaders van de klasse URLRequest.
name:String (default = "Content-Type of SOAPAction).
| |
value:String (default = "name (zoals text/plain) is gekoppeld.
|
header toegevoegd aan de array voor de eigenschap requestHeaders. De header geeft aan dat de toepassing de aanvraag moet doorsturen naar de oorspronkelijke server, zelfs wanneer deze een kopie in cache heeft geplaatst van hetgeen wordt aangevraagd.
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:42 AM Z