Méthode SetPersistentVal

La méthode SetPersistentVal enregistre une valeur dans le stockage persistant. Elle sera disponible à la prochaine exécution du script et accessible aux autres scripts.

Syntaxe

SetPersistentVal(key, val)

Paramètres

key

Obligatoire. Chaîne indiquant le nom de la valeur. Elle peut uniquement contenir les lettres A–Z majuscules et minuscules, les chiffres 0–9, le trait de soulignement, le point et les deux-points. Sa longueur est limitée à 255 caractères. Les noms des valeurs sont insensibles à la casse.

val

Valeur à enregistrer. Seuls les types chaîne et entier sont pris en charge. Pour supprimer une valeur, définissez-la sur null.

Remarques

Les valeurs persistantes étant partagées entre tous les scripts, veillez à utiliser un nom unique pour les valeurs privées. Sinon, ce nom peut entrer en conflit avec la valeur privée d’un autre script. Par convention, le nom privé suit le modèle [script_name][dot][value_name].

Pour récupérer la valeur enregistrée, le script utilise la méthode GetPersistentVal.

Exemple

JScript

// set public value
Salamander.SetPersistentVal("PublicValueName", 6);

// set private value
Salamander.SetPersistentVal("ScriptName.PrivateValueName", "hello");

// delete the value
Salamander.SetPersistentVal("ValueToDelete", null);

Voir aussi

Méthode GetPersistentVal

Objet Salamander

From the Sally manual (GPL-2.0-or-later), © 1997-2023 Open Salamander Authors; © 2025-2026 Elias Bachaalany. Source: manual source (zip) · original page in the Sally repository