ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Storing local data
They are transmitted from client to server through HTTP.
In contrast, shared objects have the following properties:
They do not expire by default.
By default, they are limited to a size of 100 KB each.
They can store simple data types (such as String, Array, and Date).
They are stored in a location specified by the application (within the user’s home directory).
They are never transmitted between the client and server.
About the SharedObject class
Flash Player 9 and later, Adobe AIR 1.0 and later
Using the SharedObject class, you can create and delete shared objects, as well as detect the current size of a
SharedObject object that you are using. The SharedObject class consists of the following methods.
Method Description
clear() Purges all of the data from the SharedObject object, and deletes the SharedObject file from the
disk.
flush() Immediately writes the SharedObject file to a file on the client.
getLocal() Returns a reference to the client’s domain-specific, local SharedObject object. If none exists, this
method creates a new shared object on the client.
getSize() Gets the size of the SharedObject file, in bytes. The default size limit is 100 KB, although it can
be larger if the client allows it.
In addition to these methods, SharedObject objects have the following properties:
Property Description
data Read-only property that represents the collection of attributes the shared object stores.
onStatus The shared object’s event handler that is invoked for every warning, error, or informational
note.
Creating a shared object
Flash Player 9 and later, Adobe AIR 1.0 and later
To create a SharedObject object, use the SharedObject.getLocal() method, which has the following syntax:
SharedObject.getLocal("objectName" [, pathname]): SharedObject
The following example creates a shared object called mySO:
public var mySO:SharedObject;
mySO = SharedObject.getLocal("preferences");
This creates a file on the client’s machine called preferences.sol.
The term local refers to the location of the shared object. In this case, Adobe® Flash® Player stores the SharedObject file
locally in the client’s home directory.
Last updated 6/6/2012
701