Flash Lite 2 
Flash Lite 2.x ActionScript-Referenzhandbuch > Elemente der ActionScript-Sprache > Globale Funktionen > getURL-Funktion

getURL-Funktion

getURL(url:String [, window:String [, method:String] ]) : Void

Lädt ein Dokument von einer bestimmten URL in ein Fenster oder übergibt Variablen an eine andere Anwendung, die sich unter einer definierten URL befindet. Zum Testen dieser Funktion muss die zu ladende Datei am angegebenen Ort gespeichert sein. Zur Verwendung einer absoluten URL (z. B. http://www.myserver.com) ist eine Netzwerkverbindung erforderlich.

Verfügbarkeit: ActionScript 1.0, Flash Lite 1.0. Die Optionen GET und POST sind nur ab diesen Versionen verfügbar.

Parameter

url:String - Die URL, von der das Dokument abgerufen werden kann.

window:String [optional] - Gibt das Fenster oder den HTML-Frame an, in das bzw. den das Dokument geladen werden soll. Geben Sie den Namen des jeweiligen Fensters ein, oder verwenden Sie einen der folgenden reservierten Zielnamen:

method:String [optional] - Legt eine HTTP-Methode (GET oder POST) zum Senden von Variablen fest. Lassen Sie diesen Parameter weg, wenn es keine 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

In diesem Beispiel wird ein Bild in einen Movieclip geladen. Wenn ein Benutzer auf das Bild klickt, wird eine neue URL in einem neuen Browserfenster geladen.

var listenerObject:Object = new Object();
listenerObject.onLoadInit = function(target_mc:MovieClip) {
 target_mc.onRelease = function() {
 getURL("http://www.macromedia.com/software/flash/flashpro/", "_blank");
 };
};
var logo:MovieClipLoader = new MovieClipLoader();
logo.addListener(listenerObject);
logo.loadClip("http://www.helpexamples.com/flash/images/image1.jpg",
 this.createEmptyMovieClip("macromedia_mc", this.getNextHighestDepth()));

Im folgenden Beispiel wird mithilfe von getURL() eine E-Mail-Nachricht gesendet:

myBtn_btn.onRelease = function(){
 getURL("mailto:you@somedomain.com");
};

Zum Senden von Variablen können Sie auch GET oder POST verwenden. Im folgenden Beispiel werden Variablen mit GET an eine URL angehängt:

var firstName:String = "Gus";
var lastName:String = "Richardson";
var age:Number = 92;
myBtn_btn.onRelease = function() {
 getURL("http://www.macromedia.com", "_blank", "GET");
};

Das folgende ActionScript sendet Variablen mit POST an den HTTP-Header. Sie sollten die Dokumente auf jeden Fall in einem Browserfenster testen, da die Variablen andernfalls mit GET gesendet werden:

var firstName:String = "Gus";
var lastName:String = "Richardson";
var age:Number = 92;
getURL("http://www.macromedia.com", "_blank", "POST");

Siehe auch

loadVariables-Funktion, send (XML.send-Methode), sendAndLoad (XML.sendAndLoad-Methode)