MACROMEDIA FLEX-FLEX ACTIONSCRIPT LANGUAGE Reference page 403

Example
The following function gets a shared object,
provided settings. Finally,
of 1000 bytes of disk space.
this.syncSettingsCore = function(soName:String, override:Boolean,
settings:Object) {
var my_so:SharedObject = SharedObject.getLocal(soName, "http://
www.mydomain.com/app/sys");
// settings list index
var i;
// For each specified value in settings:
// If override is true, set the persistent setting to the provided value.
// If override is false, fetch the persistent setting, unless there
// isn't one, in which case, set it to the provided value.
for (i in settings) {
if (override || (my_so.data[i] == null)) {
my_so.data[i] = settings[i];
} else {
settings[i] = my_so.data[i];
}
}
my_so.flush(1000);
};
SharedObject.getLocal()
Availability
Flash Player 6.
Usage
SharedObject.getLocal(objectName:String [, localPath:String]) : SharedObject
Note: The correct syntax is
myLocal_so = SharedObject.getLocal
Parameters
A string that represents the name of the object. The name can include forward
objectName
slashes ( ); for example,
/
object name, nor are the following characters:
~ % & \ ; :
An optional string parameter that specifies the full or partial path to the SWF file
localPath
that created the shared object, and that determines where the shared object will be stored locally.
The default value is the full path. See the Description section for a discussion of this parameter's
importance.
Returns
A reference to a shared object that is persistent locally and is available only to the current client. If
Flash can't create or find the shared object (for example, if
directory exists), this method returns
is called to save the settings and allot a minimum
flush()
SharedObject.getLocal
.
work/addresses
" ' , < > ? #
null
and fills writable properties with user-
my_so,
. To assign the object to a variable, use syntax like
is a legal name. Spaces are not allowed in a shared
localPath
.
was specified but no such
SharedObject.getLocal() 403