| Package | flash.net |
| Classe | public final class URLRequest |
| Héritage | URLRequest Object |
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
load() des opérations de chargement URLStream, URLLoader, Loader et autres pour lancer les téléchargements d'URL, ainsi qu’aux méthodes upload() et download() de la classe FileReference.
Pour utiliser cette classe, tenez compte du modèle de sécurité d’Adobe® Flash® Player :
Pour plus d'informations, consultez les références suivantes :
Voir aussi
| 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 | |
| contentType : String
Type de contenu MIME des données POST.
| URLRequest | ||
| data : Object
Objet contenant des données à transmettre avec la demande d’URL.
| URLRequest | ||
| method : String
Détermine si la méthode de soumission du formulaire HTTP est une opération GET ou POST.
| URLRequest | ||
![]() | prototype : Object
[static]
Référence à l’objet prototype d’un objet de classe ou fonction.
| Object | |
| requestHeaders : Array
Tableau d'en-tête de requête HTTP à ajouter à la fin de la requête HTTP.
| URLRequest | ||
| url : String
URL à demander.
| URLRequest | ||
| Méthode | Défini par | ||
|---|---|---|---|
|
URLRequest(url:String = null)
Crée un objet URLRequest.
| URLRequest | ||
![]() |
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 sous forme de chaîne de l'objet spécifié.
| Object | |
![]() |
Renvoie la valeur primitive de l'objet spécifié.
| Object | |
| contentType | propriété |
contentType:String [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Type de contenu MIME de n'importe quelles données POST.
Remarque : les méthodes FileReference.upload() et FileReference.download() ne prennent pas en charge le paramètre URLRequest.contentType.
public function get contentType():String
public function set contentType(value:String):void
| data | propriété |
data:Object [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Objet contenant des données à transmettre avec la demande d’URL.
Cette propriété s’utilise avec la propriété method. Si la valeur de URLRequest.method correspond à POST, les données sont transmises avec l’objet URLRequest par le biais de la méthode HTTP POST.
Si la valeur de URLRequest.method correspond à GET, les données définissent des variables à envoyer avec l’objet URLRequest par le biais de la méthode HTTP GET.
L'API URLRequest offre une prise en charge POST binaire et gère les variables de code URL, ainsi que les chaînes. Les objets de données peuvent être de type ByteArray, URLVariables ou String.
L’utilisation des données varie en fonction du type d’objet :
POST. GET ne gère pas les données de type ByteArray. En outre, ces données ne sont pas prises en charge par FileReference.upload() et FileReference.download().POST, les variables sont codées au format x-www-form-urlencoded et la chaîne résultante sert de données POST. Un appel de FileReference.upload() constitue une exception : les variables sont incluses en tant que champs distincts dans un envoi multipart/form-data.GET, l’objet définit des variables à envoyer avec l’objet URLRequest.POST ou GET.Les données ne sont pas envoyées tant qu’une méthode, telle que navigateToURL() ou FileReference.upload(), utilise l’objet URLRequest.
public function get data():Object
public function set data(value:Object):void
Voir aussi
Vous trouverez ci-dessous des extraits de l’exemple :
request, en utilisant l’URL de l’application distante comme paramètre.data de l'objet URLRequest.navigateToURL, qui ouvre une nouvelle fenêtre de navigateur vers l’URL de l’application distante.Remarque : pour exécuter l’exemple, l’URL de l'application distante de l'exemple doit être remplacée par une URL opérationnelle. En outre, du code serveur serait nécessaire pour traiter les informations capturées par Flash Player dans l’objet URLVariables.
package {
import flash.display.Sprite;
import flash.net.navigateToURL;
import flash.net.URLRequest;
import flash.net.URLVariables;
public class URLVariablesExample extends Sprite {
public function URLVariablesExample() {
var url:String = "http://www.[yourDomain].com/application.jsp";
var request:URLRequest = new URLRequest(url);
var variables:URLVariables = new URLVariables();
variables.exampleSessionId = new Date().getTime();
variables.exampleUserLabel = "guest";
request.data = variables;
navigateToURL(request);
}
}
}| method | propriété |
method:String [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Détermine si la méthode de soumission du formulaire HTTP est une opération GET ou POST. Les valeurs gérées sont URLRequestMethod.GET ou URLRequestMethod.POST.
La valeur par défaut est URLRequestMethod.GET.
public function get method():String
public function set method(value:String):void
ArgumentError — Si le paramètre value n'est pas URLRequestMethod.GET ou URLRequestMethod.POST.
|
Voir aussi
URLRequest.method sur URLRequestMethod.POST.
Vous trouverez ci-dessous des extraits de l’exemple :
request, en utilisant l’URL de l’application distante comme paramètre.data de l'objet URLRequest.URLRequest.method est définie sur URLRequestMethod.POST.navigateToURL, qui ouvre une nouvelle fenêtre de navigateur vers l’URL de l’application distante.Remarque : pour exécuter l’exemple, l’URL de l'application distante de l'exemple doit être remplacée par une URL opérationnelle. En outre, du code serveur serait nécessaire pour traiter les informations capturées par Flash Player dans l’objet URLVariables.
package {
import flash.display.Sprite;
import flash.net.navigateToURL;
import flash.net.URLRequest;
import flash.net.URLRequestMethod;
import flash.net.URLVariables;
public class URLRequest_method extends Sprite {
public function URLRequest_method() {
var url:String = "http://www.[yourDomain].com/application.jsp";
var request:URLRequest = new URLRequest(url);
var variables:URLVariables = new URLVariables();
variables.exampleSessionId = new Date().getTime();
variables.exampleUserLabel = "guest";
request.data = variables;
request.method = URLRequestMethod.POST;
navigateToURL(request);
}
}
}| requestHeaders | propriété |
requestHeaders:Array [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Tableau d'en-tête de requête HTTP à ajouter à la fin de la requête HTTP. Le tableau se compose d’objets URLRequestHeader. Tous les objets du tableau doivent être de type URLRequestHeader et contenir une chaîne de nom et une chaîne de valeur, comme suit :
var rhArray:Array = new Array(new URLRequestHeader("Content-Type", "text/html"));
Flash Player impose certaines restrictions sur les en-têtes de requête. Pour en savoir plus, consultez la description de la classe URLRequestHeader.
Les méthodes FileReference.upload() et FileReference.download() ne prennent pas en charge le paramètre URLRequest.requestHeaders.
public function get requestHeaders():Array
public function set requestHeaders(value:Array):void
Voir aussi
| url | propriété |
url:String [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
URL à demander. Par défaut, l’URL doit se trouver dans exactement le même domaine que le fichier SWF appelant, sous-domaines compris. Les fichiers SWF qui figurent aux adresses www.adobe.com et store.adobe.com, par exemple, sont dans des domaines différents. Pour charger des données à partir d'un autre domaine, placez un fichier de régulation interdomaines dans le serveur qui héberge le fichier SWF. Pour plus d’informations, reportez-vous aux informations relatives à la sécurité dans la description de la classe URLRequest.
Remarque : Flash Player Mise à jour 3 et les versions ultérieures supportent IPv6 (Internet Protocol version 6). IPv6 est une version du protocole IP (Internet Protocol) qui prend en charge les adresses 128 bits (amélioration du protocole IPv4 précédent qui prend en charge les adresses 32 bits). Vous devrez peut-être activer IPv6 sur vos interfaces de mise en réseau. Pour plus d'informations, consultez l'Aide du système d'exploitation hébergeant les données. Si IPv6 est pris en charge sur le système hébergeant, vous pouvez spécifier des adresses littérales IPv6 numériques dans les URL entre crochets ([]), comme suit :
rtmp://[2001:db8:ccc3:ffff:0:444d:555e:666f]:1935/test
public function get url():String
public function set url(value:String):void
| URLRequest | () | Constructeur |
public function URLRequest(url:String = null)
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Crée un objet URLRequest. Si System.useCodePage correspond à true, la requête est codée via la page de code système, plutôt que le format Unicode. Si System.useCodePage correspond à false, la requête est codée via le format Unicode, plutôt que la page de code système.
url:String (default = null) — URL à demander. Vous pourrez définir l’URL ultérieurement à l'aide de la propriété url.
|
Voir aussi
complete est distribué et les données du fichier XML sont écrites dans le résultat. Des gestionnaires d'événements supplémentaires capturent d’autres événements, y compris des événements d'erreur.
Pour exécuter cet exemple, placez un fichier nommé XMLFile.xml dans le même répertoire que votre fichier SWF.
package {
import flash.display.Sprite;
import flash.events.*;
import flash.net.*;
public class URLRequestExample extends Sprite {
public function URLRequestExample() {
var loader:URLLoader = new URLLoader();
configureListeners(loader);
var request:URLRequest = new URLRequest("XMLFile.xml");
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);
}
}
}
M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire
Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/net/URLRequest.html