Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
flash.net 

URLVariables  - AS3

Packageflash.net
Classepublic dynamic class URLVariables
HéritageURLVariables Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

La classe URLVariables vous permet de transférer des variables entre une application et un serveur. Utilisez les objets URLVariables avec des méthodes de la classe URLLoader, avec la propriété data de la classe URLRequest et des fonctions de package flash.net.

Consulter les exemples

Informations complémentaires

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
Méthodes publiques
 MéthodeDéfini par
  
URLVariables(source:String = null)
Crée un nouvel objet URLVariables.
URLVariables
  
Convertit la chaîne de variables en propriétés de l’objet URLVariables spécifié.
URLVariables
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
  
Renvoie une chaîne contenant toutes les variables énumérables, au format de l’application de codage du contenu MIME/x-www-form-urlencoded.
URLVariables
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Détails du constructeur

URLVariables

()Constructeur
public function URLVariables(source:String = null)

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Crée un nouvel objet URLVariables. Vous transmettez des objets URLVariables à la propriété data des objets URLRequest.

Si vous appelez le constructeur URLVariables avec une chaîne, la méthode decode() est appelée automatiquement pour convertir la chaîne en propriétés de l’objet URLVariables.

Paramètres
source:String (default = null) — Chaîne codée au format URL contenant des paires nom/valeur.
Détails de la méthode

decode

()méthode
public function decode(source:String):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Convertit la chaîne de variables en propriétés de l’objet URLVariables spécifié.

Cette méthode est utilisée en interne par les événements URLVariables. La plupart des utilisateurs n’a pas besoin d’appeler cette méthode directement.

Paramètres

source:String — Chaîne de requête codée au format URL et contenant des paires nom/valeur.


Valeur émise
Error — Le paramètre source doit être une chaîne de requête codée au format URL et contenant des paires nom/valeur.

Informations complémentaires


Exemple  ( Comment utiliser cet exemple )

Les exemples suivants indiquent comment analyser les chaînes codées dans l’URL. Exemple fourni par ActionScriptExamples.com.
// The first method passes the string to be decoded to the URLVariables class constructor:
var urlVariables:URLVariables = new URLVariables("firstName=Tom&lastName=Jones");
lbl.text = urlVariables.lastName + "," + urlVariables.firstName;

// The second method uses the decode() method to parse the URL encoded string:
var urlVariables:URLVariables = new URLVariables();
urlVariables.decode("firstName=Tom&lastName=Jones");
lbl.text = urlVariables.lastName + "," + urlVariables.firstName;

toString

()méthode 
public function toString():String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie une chaîne contenant toutes les variables énumérables, au format de l’application de codage du contenu MIME/x-www-form-urlencoded.

Valeur renvoyée
String — Chaîne codée au format URL contenant des paires nom/valeur.
URLVariablesExample.as

L’exemple suivant ouvre l’application distante hébergée à l’adresse http://www.[yourDomain].com/application.jsp dans une nouvelle fenêtre de navigateur et transmet à l’application des données relatives à une session utilisateur, capturées dans un objet URLVariables.

Vous trouverez ci-dessous des extraits de l’exemple :

  1. La fonction constructeur crée une occurrence de URLRequest nommée request, en utilisant l’URL de l’application distante comme paramètre.
  2. Un objet URLVariables est créé et des valeurs sont attribuées à deux de ses propriétés.
  3. L’objet URLVariables est affecté à la propriété data de l’objet URLRequest.
  4. L’exemple appelle 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);
        }
    }
}




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.