Packageflash.net
Classpublic dynamic class URLVariables
InheritanceURLVariables Inheritance Object

Language version: ActionScript 3.0
Runtime version: 

The URLVariables class allows you to transfer variables between an application and a server. Use URLVariables objects with methods of the URLLoader class, with the data property of the URLRequest class, and with flash.net package functions.

View the examples.

See also

URLLoader


Public Properties
 PropertyDefined by
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
Public Methods
 MethodDefined by
  
URLVariables(source:String = null)
Creates a new URLVariables object.
URLVariables
  
decode(source:String):void
Converts the variable string to properties of the specified URLVariables object.
URLVariables
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
  
Returns a string containing all enumerable variables, in the MIME content encoding application/x-www-form-urlencoded.
URLVariables
 Inherited
Returns the primitive value of the specified object.
Object
Constructor detail
URLVariables()constructor
public function URLVariables(source:String = null)

Language version: ActionScript 3.0
Runtime version: 

Creates a new URLVariables object. You pass URLVariables objects to the data property of URLRequest objects.

If you call the URLVariables constructor with a string, the decode() method is automatically called to convert the string to properties of the URLVariables object.

Parameters
source:String (default = null) — A URL-encoded string containing name/value pairs.
Method detail
decode()method
public function decode(source:String):void

Language version: ActionScript 3.0
Runtime version: 

Converts the variable string to properties of the specified URLVariables object.

This method is used internally by the URLVariables events. Most users do not need to call this method directly.

Parameters
source:String — A URL-encoded query string containing name/value pairs.

Throws
Error — The source parameter must be a URL-encoded query string containing name/value pairs.

Example
The following examples show how you can parse URL encoded strings. Example provided by 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()method 
public function toString():String

Language version: ActionScript 3.0
Runtime version: 

Returns a string containing all enumerable variables, in the MIME content encoding application/x-www-form-urlencoded.

Returns
String — A URL-encoded string containing name/value pairs.
Examples
examples\URLVariablesExample
The following example opens the remote application hosted at http://www.[yourDomain].com/application.jsp in a new browser window and passes data about a user session, captured in a URLVariables object, to the application.

Highlights of the example follow:

  1. The constructor function creates a URLRequest instance named request, taking the URL of the remote application as a parameter.
  2. A URLVariables object is created and two of its properties are assigned values.
  3. The URLVariables object is assigned to the data property of the URLRequest object.
  4. The example calls navigateToURL, which opens a new browser window to the remote application's URL.

Note: To run the example, the remote application URL in the example must be replaced with a working URL. Additionally, you would need server code to process the information captured by Flash Player in the URLVariables object.

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);
        }
    }
}