Sharedobject.data - MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference

SharedObject.data

Availability
Flash Player 6.
Usage
myLocalSharedObject.data:Object
Description
Property; the collection of attributes assigned to the
can be shared and/or stored. Each attribute can be an object of any basic ActionScript or
JavaScript type—Array, Number, Boolean, and so on. For example, the following lines assign
values to various aspects of a shared object:
var items_array:Array = new Array(101, 346, 483);
var currentUserIsAdmin:Boolean = true;
var currentUserName:String = "Ramona";
var my_so:SharedObject = SharedObject.getLocal("superfoo");
my_so.data.itemNumbers = items_array;
my_so.data.adminPrivileges = currentUserIsAdmin;
my_so.data.userName = currentUserName;
for (var prop in my_so.data) {
trace(prop+": "+my_so.data[prop]);
}
All attributes of a shared object's
object contains the following information:
userName: Ramona
adminPrivileges: true
itemNumbers: 101,346,483
Note: Do not assign values directly to the
so.data = someValue
To delete attributes for local shared objects, use code such as
setting an attribute to
To create private values for a shared object—values that are available only to the client instance
while the object is in use and are not stored with the object when it is closed—create properties
that are not named
var my_so:SharedObject = SharedObject.getLocal("superfoo");
my_so.favoriteColor = "blue";
my_so.favoriteNightClub = "The Bluenote Tavern";
my_so.favoriteSong = "My World is Blue";
for (var prop in my_so) {
trace(prop+": "+my_so[prop]);
}
738 Chapter 2: ActionScript Language Reference
property are saved if the object is persistent, and the shared
data
data
; Flash ignores these assignments.
or
null undefined
to store them, as shown in the following example:
data
property of the object; these attributes
data
property of a shared object, as in
delete so.data.attributeName
for a local shared object does not delete the attribute.
;