SetPersistentVal-Methode

Die Methode SetPersistentVal speichert einen Wert im dauerhaften Speicher. Der Wert ist beim nächsten Skriptaufruf wieder verfügbar und auch für andere Skripte zugänglich.

Syntax

SetPersistentVal(key, val)

Parameter

key

Erforderlich. Zeichenfolge mit dem Namen des Werts. Sie darf nur Groß- und Kleinbuchstaben A–Z, Ziffern 0–9, Unterstrich, Punkt und Doppelpunkt enthalten. Die Länge ist auf 255 Zeichen begrenzt. Bei Wertnamen wird die Groß-/Kleinschreibung nicht beachtet.

val

Zu speichernder Wert. Nur Zeichenfolgen- und Ganzzahltypen werden unterstützt. Zum Löschen eines Werts setzen Sie ihn auf null.

Anmerkungen

Da dauerhafte Werte zwischen allen Skripten geteilt werden, sollten Sie für private Werte eindeutige Namen verwenden. Andernfalls kann der Name mit einem privaten Wert eines anderen Skripts kollidieren. Üblicherweise wird ein privater Name nach dem Schema [script_name][dot][value_name] gebildet.

Zum Abrufen des gespeicherten Werts verwendet das Skript die Methode GetPersistentVal.

Beispiel

JScript

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

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

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

Siehe auch

GetPersistentVal-Methode

Salamander-Objekt