User Guide

LoadVars.load() 389
LoadVars.load()
Availability
Flash Player 6; behavior changed in Flash Player 7.
Usage
my_lv.load(url:String) : Boolean
Parameters
url
A string; the URL from which to download the variables. If the SWF file issuing this call is
running in a web browser,
url must be in the same domain as the SWF file; for details, see the
Description section.
Returns
A Boolean value; false if no parameter is specified, true otherwise.
Description
Method; downloads variables from the specified URL, parses the variable data, and places the
resulting variables into
my_lv. Any properties in my_lv with the same names as downloaded
variables are overwritten. Any properties in
my_lv with different names than downloaded
variables are not deleted. This is an asynchronous action.
The downloaded data must be in the MIME content type application/x-www-form-urlencoded.
This is the same format used by loadVariables().
In SWF files running in a version of the player earlier than Flash Player 7,
url must be in the
same superdomain as the SWF file that is issuing this call. A superdomain is derived by removing
the left-most component of a file’s URL. For example, a SWF file at www.someDomain.com can
load data from sources at store.someDomain.com because both files are in the same superdomain
named someDomain.com.
In SWF files of any version running in Flash Player 7 or later,
url must be in exactly the same
domain (see “Flash Player security features” in Using ActionScript in Flash). For example, a SWF
file at www.someDomain.com can load data only from sources that are also at
www.someDomain.com. If you want to load data from a different domain, you can place a cross-
domain policy file on the server hosting the SWF file. For more information, see “About allowing
cross-domain data loading” in Using ActionScript in Flash.
Also, in files published for Flash Player 7, case-sensitivity (see “Case sensitivity” in Using
ActionScript in Flash) is supported for external variables loaded with
LoadVars.load().
This method is similar to
XML.load().
Example
The following code defines an onLoad handler function that signals when data is returned to the
Flash application from a server-side PHP script, and then loads the data in passvars.php.
var my_lv:LoadVars = new LoadVars();
my_lv.onLoad = function(success:Boolean) {
if (success) {