ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Storing local data
When you create a shared object, Flash Player creates a new directory for the application and domain inside its
sandbox. It also creates a *.sol file that stores the SharedObject data. The default location of this file is a subdirectory
of the user’s home directory. The following table shows the default locations of this directory:
Operating System Location
Windows
95/98/ME/2000/XP
c:/Documents and Settings/username/Application
Data/Macromedia/Flash Player/#SharedObjects
Windows Vista c:/Users/username/AppData/Roaming/Macromedia/Flash
Player/#SharedObjects
Macintosh OS X /Users/username/Library/Preferences/Macromedia/Flash
Player/#SharedObjects/web_domain/path_to_application/applicatio
n_name/object_name.sol
Linux/Unix /home/username/.macromedia/Flash_Player/#SharedObjects/web_doma
in/path_to_application/application_name/object_name.sol
Below the #SharedObjects directory is a randomly-named directory. Below that is a directory that matches the
hostname, then the path to the application, and finally the *.sol file.
For example, if you request an application named MyApp.swf on the local host, and within a subdirectory named /sos,
Flash Player stores the *.sol file in the following location on Windows XP:
c:/Documents and Settings/fred/Application Data/Macromedia/Flash
Player/#SharedObjects/KROKWXRK/#localhost/sos/MyApp.swf/data.sol
Note: If you do not provide a name in the SharedObject.getLocal() method, Flash Player names the file
undefined.sol.
By default, Flash can save locally persistent SharedObject objects of up to 100 KB per domain. This value is userconfigurable.
When the application tries to save data to a shared object that would make it bigger than 100 KB, Flash
Player displays the Local Storage dialog box, which lets the user allow or deny more local storage for the domain that
is requesting access.
Specifying a path
Flash Player 9 and later, Adobe AIR 1.0 and later
You can use the optional pathname parameter to specify a location for the SharedObject file. This file must be a
subdirectory of that domain’s SharedObject directory. For example, if you request an application on the localhost and
specify the following:
mySO = SharedObject.getLocal("myObjectFile","/");
Flash Player writes the SharedObject file in the /#localhost directory (or /localhost if the application is offline). This is
useful if you want more than one application on the client to be able to access the same shared object. In this case, the
client could run two Flex applications, both of which specify a path to the shared object that is the root of the domain;
the client could then access the same shared object from both applications. To share data between more than
application without persistence, you can use the LocalConnection object.
If you specify a directory that does not exist, Flash Player does not create a SharedObject file.
Last updated 6/6/2012
702