Guide de reference du langage ActionScript 2.0 - PowWeb

Voir également
clear (méthode SharedObject.clear), onStatus (gestionnaire
SharedObject.onStatus)
getLocal (méthode SharedObject.getLocal)
public static getLocal(name:String, [localPath:String], [secure:Boolean]) :
SharedObject
Renvoie une référence à un objet partagé persistant localement disponible uniquement pour le
client actuel. Si l'objet partagé n'existe pas encore, cette méthode en crée un. Il s'agit d'une
méthode statique de la classe SharedObject. Pour affecter l'objet à une variable, utilisez une
syntaxe du type suivant :
var so:SharedObject = SharedObject.getLocal("savedData")
Remarque : si l'utilisateur a choisi de ne jamais autoriser l'enregistrement local pour ce
domaine, l'objet n'est pas enregistré localement, même si une valeur est spécifiée pour
localPath. L'exception à cette règle est le contenu local. Un contenu local peut toujours
écrire des objets partagés par un domaine tiers sur un disque (domaines autres que le domaine
de la barre d'adresse du navigateur actuel), quoiqu'il soit interdit à un domaine tiers d'écrire
des objets partagés sur un disque.
Pour éviter les collisions de noms, Flash examine l'emplacement du fichier SWF qui crée
l'objet partagé. Par exemple, si un fichier SWF à l'adresse www.myCompany.com/apps/
stockwatcher.swf crée un objet partagé nommé portfolio, cet objet partagé n'entre pas en
conflit avec un autre objet nomméportfolio qui a été créé par un fichier SWF à l'adresse
www.yourCompany.com/photoshoot.swf, étant donné que les fichiers SWF proviennent de
répertoires différents.
Même si le paramètre localPath est facultatif, vous devez réfléchir à son utilisation, en
particulier si les autres fichiers SWF doivent accéder à l'objet partagé. Si les données dans
l'objet partagé sont spécifiques à un fichier SWF qui ne sera pas déplacé vers un autre
emplacement, l'utilisation de la valeur par défaut a alors du sens. Si les autres fichiers SWF
nécessitent un accès à l'objet partagé ou si le fichier SWF qui crée l'objet partagé est déplacé,
la valeur de ce paramètre peut alors avoir un effet sur la capacité des fichiers SWF à accéder à
l'objet partagé. Par exemple, si vous créez un objet partagé avec localPath défini sur la valeur
par défaut du chemin complet vers le fichier SWF, aucun autre fichier SWF ne pourra accéder
à cet objet partagé. Si vous déplacez par la suite le fichier SWF d'origine vers un autre
emplacement, ce fichier SWF ne pourra pas accéder aux données déjà enregistrées dans l'objet
partagé.
1126 Chapitre 2: Classes ActionScript