方法 SetPersistentVal

SetPersistentVal 方法将值保存到持久存储中。下次调用脚本时仍可使用该值,其他脚本也可以访问。

语法

SetPersistentVal(key, val)

参数

key

必需。指定值名称的字符串。字符串只能包含大小写字母 A–Z、数字 0–9、下划线、点和冒号。字符串长度限制为 255 个字符。值名称不区分大小写。

val

要保存的值。仅支持字符串和整数数据类型。要删除值,请将其设为 null。

备注

由于持久值在所有脚本之间共享,应确保私有值使用唯一名称,否则可能与其他脚本的私有值发生名称冲突。按约定,私有名称采用 [script_name][dot][value_name] 格式。

脚本使用 GetPersistentVal 方法获取已保存的值。

示例

JScript

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

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

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

另请参阅

方法 GetPersistentVal

对象 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