loadVariablesNum-Funktion

loadVariablesNum(url:String, level:Number [, method:String]) : Void

Liest Daten aus einer externen Datei, beispielsweise aus einer Textdatei oder aus Text, der von ColdFusion, einem CGI-, ASP, PHP- oder Perl-Skript generiert wurde, und setzt die Werte für Variablen in eine Flash Player-Stufe ein. Mit dieser Funktion können auch Variablen in der aktiven SWF-Datei durch neue Werte aktualisiert werden.

Der Text an der angegebenen URL muss im MIME-Standardformat application/x-www-form-urlencoded (einem von CGI-Skripts verwendeten Standardformat) vorliegen. Es kann eine beliebige Anzahl von Variablen angegeben werden. Mit dem folgenden Ausdruck werden z. B. mehrere Variablen definiert:

Bei SWF-Dateien, die in einer Version vor Flash Player 7 ausgeführt werden, muss sich url in derselben Superdomäne befinden wie die SWF-Datei, die diesen Aufruf ausgibt. Eine Superdomäne wird durch Entfernen der äußeren linken Komponente der URL einer Datei abgeleitet. Eine SWF-Datei unter www.someDomain.com kann beispielsweise Daten von einer Quelle unter store.someDomain.com laden, da sich beide Dateien in derselben Superdomäne someDomain.com befinden.

Bei SWF-Dateien, die in Flash Player ab Version 7 ausgeführt werden, muss sich url in genau derselben Domäne befinden wie die SWF-Datei, aus der dieser Aufruf erfolgt (siehe "Flash Player-Sicherheitsfunktionen" in ActionScript in Flash verwenden). Eine SWF-Datei unter www.someDomain.com kann beispielsweise nur Daten von solchen Quellen laden, die sich ebenfalls unter www.someDomain.com befinden. Wenn Sie Daten von einer anderen Domäne laden möchten, können Sie auf dem Server, auf dem sich die SWF-Datei befindet, eine domänenübergreifende Richtliniendatei ablegen. Weitere Informationen zum Thema "Domänenübergreifendes Laden von Daten ermöglichen" finden Sie im Handbuch ActionScript in Flash verwenden.

Wenn Sie Variablen in einen Ziel-Movieclip laden möchten, verwenden Sie loadVariables() anstelle von loadVariablesNum().

Verfügbarkeit: ActionScript 1.0, Flash Lite 1.1. Verhalten wurde ab Flash Player 7 geändert. Flash 4-Dateien, die in Flash ab Version 5 geöffnet werden, werden in die korrekte Syntax umgewandelt.

Parameter

url:String - Eine absolute oder relative URL, an der sich die Variablen befinden. Wenn die SWF-Datei, die diesen Aufruf ausgibt, in einem Webbrowser ausgeführt wird, muss sich url in derselben Domäne befinden wie die SWF-Datei. Weitere Einzelheiten finden Sie im Abschnitt "Beschreibung".

level:Number - Eine Ganzzahl, die die Stufe im Flash Player angibt, in die die Variablen geladen werden sollen.

method:String [optional] - Legt eine HTTP-Methode zum Senden von Variablen fest. Dieser Parameter muss den String GET oder POST enthalten. Lassen Sie diesen Parameter weg, wenn es keine zu sendenden Variablen gibt. Bei der Methode GET werden die Variablen am Ende der URL angehängt. Diese Methode wird zum Senden einer kleineren Anzahl von Variablen verwendet. Bei der Methode POST, die zum Senden langer Variablenstrings verwendet wird, werden die Variablen in einem separaten HTTP-Header gesendet.

Beispiel

Im folgenden Beispiel werden Informationen aus der Textdatei params.txt in die Hauptzeitleiste der SWF-Datei in Stufe 2 des Flash Players geladen. Die Variablennamen der Textfelder müssen mit den Variablennamen in der Datei params.txt übereinstimmen. Mithilfe der Funktion setInterval() wird der Ladevorgang der Datei in die SWF-Datei überwacht. Das Skript sucht nach einer Variablen in der Datei params.txt mit dem Namen done.

loadVariablesNum("params.txt", 2);
function checkParamsLoaded() {
 if (_level2.done == undefined) {
 trace("not yet.");
 } else {
 trace("finished loading. killing interval.");
 trace("-------------");
 for (i in _level2) {
 trace(i+": "+_level2[i]);
 }
 trace("-------------");
 clearInterval(param_interval);
 }
}
var param_interval = setInterval(checkParamsLoaded, 100);

// Params.txt enthält folgenden Text:
var1="hello"&var2="goodbye"&done="done"

loadVariablesNum-Funktion

Parameter

Beispiel

Siehe auch