LoadVars.load()

Availability

Flash Player 6; behavior changed in Flash Player 7.

Usage

my_lv.load(url)

Parameters

url 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 "Description," below.

Returns

A string.

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. For example, a SWF file at www.someDomain.com can load variables from a SWF file at store.someDomain.com, because both files are in the same superdomain of 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). For example, a SWF file at www.someDomain.com can load variables only from SWF files that are also at www.someDomain.com. If you want to load variables from a different domain, you can place a cross-domain policy file on the server hosting the SWF file that is being accessed. For more information, see About allowing cross-domain data loading.

Also, in files published for Flash Player 7, case sensitivity (see Case sensitivity) is supported for external variables loaded with LoadVars.load().

This method is similar to XML.load().