| Paket | flash.net |
| Klasse | public final class URLRequest |
| Vererbung | URLRequest Object |
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
load()-Methoden von URLStream, URLLoader, Loader und anderen Ladevorgängen übergeben, um die URL-Downloads zu starten, sowie an die upload()- und download()-Methoden der FileReference-Klasse.
Beachten Sie bei Verwendung dieser Klasse das folgende Sicherheitsmodell von Adobe® Flash® Player:
Weitere Informationen finden Sie in den folgenden Abschnitten:
Siehe auch
| Eigenschaft | Definiert von | ||
|---|---|---|---|
![]() | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
| Object | |
| contentType : String
Der MIME-Inhaltstyp der POST-Daten.
| URLRequest | ||
| data : Object
Ein Objekt, das mit der URL-Anforderung zu übertragende Daten enthält.
| URLRequest | ||
| method : String
Steuert, ob als HTTP-Übertragungsmethode ein GET- oder ein POST-Vorgang verwendet wird.
| URLRequest | ||
![]() | prototype : Object
[static]
Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
| Object | |
| requestHeaders : Array
Das Array der an die HTTP-Anforderung anzuhängenden HTTP-Anforderungsheader.
| URLRequest | ||
| url : String
Die anzufordernde URL.
| URLRequest | ||
| Methode | Definiert von | ||
|---|---|---|---|
|
URLRequest(url:String = null)
Erstellt ein URLRequest-Objekt.
| URLRequest | ||
![]() |
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
| Object | |
![]() |
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
| Object | |
![]() |
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
| Object | |
![]() |
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
| Object | |
![]() |
Gibt das angegebene Objekt als String zurück.
| Object | |
![]() |
Gibt den Grundwert des angegebenen Objekts zurück.
| Object | |
| contentType | Eigenschaft |
contentType:String [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Der MIME-Inhaltstyp der POST-Daten.
Hinweis: Der Parameter URLRequest.contentType wird von den Methoden FileReference.upload() und FileReference.download() nicht unterstützt.
public function get contentType():String
public function set contentType(value:String):void
| data | Eigenschaft |
data:Object [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Ein Objekt, das mit der URL-Anforderung zu übertragende Daten enthält.
Diese Eigenschaft wird mit der Eigenschaft method verwendet. Wenn URLRequest.method den Wert POST aufweist, werden die Daten mit dem URLRequest-Objekt und der HTTP-Methode POST übertragen.
Wenn URLRequest.method den Wert GET aufweist, definieren die Daten Variablen, die mit dem URLRequest-Objekt und der HTTP-Methode GET gesendet werden.
Die API für "URLRequest" unterstützt binäre POST-Daten sowie URL-codierte Variablen und Strings. Das Datenobjekt kann den Typ "ByteArray", "URLVariables" oder "String" aufweisen.
Die Verwendung der Daten hängt vom Objekttyp ab:
POST-Daten verwendet. Der Objekttyp "ByteArray" wird für GET-Daten nicht unterstützt. Dasselbe gilt für FileReference.upload() und FileReference.download().POST verwendet wird, werden die Variablen im Format x-www-form-urlencoded codiert, und der Ergebnisstring wird als POST-Daten verwendet. Eine Ausnahme bildet hier der Aufruf von FileReference.upload(), bei dem die Variablen als separate Felder in einem multipart/form-data-Post gesendet werden.GET verwendet wird, definiert das URLVariables-Objekt die Variablen, die mit dem URLRequest-Objekt gesendet werden.POST- oder GET-Daten verwendet wird.Die Daten werden erst gesendet, wenn eine Methode (z. B. navigateToURL() oder FileReference.upload()) das URLRequest-Objekt verwendet.
public function get data():Object
public function set data(value:Object):void
Siehe auch
Wichtige Beispielauszüge:
request, wobei die URL der Remote-Anwendung als Parameter verwendet wird.data des URLRequest-Objekts zugewiesen.navigateToURL auf, wodurch ein neues Browserfenster mit der URL der Remote-Anwendung geöffnet wird.Hinweis: Zur Ausführung des Beispiels muss die URL der Remote-Anwendung durch eine gültige URL ersetzt werden. Darüber hinaus benötigen Sie Servercode, um die von Flash Player im URLVariables-Objekt erfassten Informationen auszuführen.
package {
import flash.display.Sprite;
import flash.net.navigateToURL;
import flash.net.URLRequest;
import flash.net.URLVariables;
public class URLVariablesExample extends Sprite {
public function URLVariablesExample() {
var url:String = "http://www.[yourDomain].com/application.jsp";
var request:URLRequest = new URLRequest(url);
var variables:URLVariables = new URLVariables();
variables.exampleSessionId = new Date().getTime();
variables.exampleUserLabel = "guest";
request.data = variables;
navigateToURL(request);
}
}
}| method | Eigenschaft |
method:String [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Steuert, ob als HTTP-Übertragungsmethode ein GET- oder ein POST-Vorgang verwendet wird. Gültige Werte sind URLRequestMethod.GET und URLRequestMethod.POST.
Der Standardwert lautet URLRequestMethod.GET.
public function get method():String
public function set method(value:String):void
ArgumentError — Der Parameter value ist nicht URLRequestMethod.GET oder URLRequestMethod.POST.
|
Siehe auch
URLRequest.method wird explizit auf URLRequestMethod.POST gesetzt.
Wichtige Beispielauszüge:
request, wobei die URL der Remote-Anwendung als Parameter verwendet wird.data des URLRequest-Objekts zugewiesen.URLRequest.method wird auf URLRequestMethod.POST gesetzt.navigateToURL auf, wodurch ein neues Browserfenster mit der URL der Remote-Anwendung geöffnet wird.Hinweis: Zur Ausführung des Beispiels muss die URL der Remote-Anwendung durch eine gültige URL ersetzt werden. Darüber hinaus benötigen Sie Servercode, um die von Flash Player im URLVariables-Objekt erfassten Informationen auszuführen.
package {
import flash.display.Sprite;
import flash.net.navigateToURL;
import flash.net.URLRequest;
import flash.net.URLRequestMethod;
import flash.net.URLVariables;
public class URLRequest_method extends Sprite {
public function URLRequest_method() {
var url:String = "http://www.[yourDomain].com/application.jsp";
var request:URLRequest = new URLRequest(url);
var variables:URLVariables = new URLVariables();
variables.exampleSessionId = new Date().getTime();
variables.exampleUserLabel = "guest";
request.data = variables;
request.method = URLRequestMethod.POST;
navigateToURL(request);
}
}
}| requestHeaders | Eigenschaft |
requestHeaders:Array [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Das Array der an die HTTP-Anforderung anzuhängenden HTTP-Anforderungsheader. Das Array besteht aus URLRequestHeader-Objekten. Jedes Objekt im Array muss ein URLRequestHeader-Objekt sein und einen Namens- und einen Wert-String enthalten:
var rhArray:Array = new Array(new URLRequestHeader("Content-Type", "text/html"));
In Flash Player gelten bestimmte Einschränkungen für Anforderungsheader. Weitere Informationen hierzu finden Sie in der Beschreibung der URLRequestHeader-Klasse.
Die Methoden FileReference.upload() und FileReference.download() unterstützen den Parameter URLRequest.requestHeaders nicht.
public function get requestHeaders():Array
public function set requestHeaders(value:Array):void
Siehe auch
| url | Eigenschaft |
url:String [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die anzufordernde URL. In der Standardeinstellung muss sich die URL in derselben Domäne befinden wie die aufrufende SWF-Datei, einschließlich Subdomänen. Bei www.adobe.com und store.adobe.com handelt es sich beispielsweise um unterschiedliche Domänen. Legen Sie eine domänenübergreifende Richtliniendatei auf dem Server ab, auf dem sich die Daten befinden, um Daten von einer anderen Domäne zu laden. Weitere Informationen finden Sie in den Sicherheitsinformationen in der Beschreibung der URLRequest-Klasse.
Hinweis: Flash Player Update 3 und höher unterstützt IPv6 (Internet Protocol Version 6). IPv6 ist eine Internet Protocol-Version, die 128-Bit-Adressen unterstützt (eine Verbesserung gegenüber der älteren Version IPv4, die 32-Bit-Adressen unterstützt). Möglicherweise müssen Sie IPv6 für Ihre Netzwerkschnittstellen aktivieren. Weitere Informationen finden Sie in der Hilfe des Betriebssystems, unter dem die Daten gehostet werden. Wenn IPv6 vom Hostingsystem unterstützt wird, können Sie in URLs numerische IPv6-Literaladressen in eckigen Klammern angeben, wie im folgenden Beispiel:
rtmp://[2001:db8:ccc3:ffff:0:444d:555e:666f]:1935/test
public function get url():String
public function set url(value:String):void
| URLRequest | () | Konstruktor |
public function URLRequest(url:String = null)
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Erstellt ein URLRequest-Objekt. Wenn System.useCodePage auf true gesetzt ist, wird die Anforderung mit der Codepage des Systems codiert. Wenn System.useCodePage auf false gesetzt ist, wird die Anforderung mit Unicode codiert.
url:String (default = null) — Die anzufordernde URL. Sie können die URL zu einem späteren Zeitpunkt mithilfe der Eigenschaft url festlegen.
|
Siehe auch
complete-Ereignis ausgelöst, und die Daten in der XML-Datei werden in die Ausgabe geschrieben. Andere Ereignisse einschließlich Fehlerereignisse werden von zusätzlichen Ereignisprozeduren erfasst.
Legen Sie zur Ausführung dieses Beispiels eine Datei mit dem Namen "XMLFile.xml" in dem Verzeichnis ab, in dem sich die SWF-Datei befindet.
package {
import flash.display.Sprite;
import flash.events.*;
import flash.net.*;
public class URLRequestExample extends Sprite {
public function URLRequestExample() {
var loader:URLLoader = new URLLoader();
configureListeners(loader);
var request:URLRequest = new URLRequest("XMLFile.xml");
try {
loader.load(request);
} catch (error:Error) {
trace("Unable to load requested document.");
}
}
private function configureListeners(dispatcher:IEventDispatcher):void {
dispatcher.addEventListener(Event.COMPLETE, completeHandler);
dispatcher.addEventListener(Event.OPEN, openHandler);
dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
}
private function completeHandler(event:Event):void {
var loader:URLLoader = URLLoader(event.target);
trace("completeHandler: " + loader.data);
}
private function openHandler(event:Event):void {
trace("openHandler: " + event);
}
private function progressHandler(event:ProgressEvent):void {
trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
}
private function securityErrorHandler(event:SecurityErrorEvent):void {
trace("securityErrorHandler: " + event);
}
private function httpStatusHandler(event:HTTPStatusEvent):void {
trace("httpStatusHandler: " + event);
}
private function ioErrorHandler(event:IOErrorEvent):void {
trace("ioErrorHandler: " + event);
}
}
}
Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht
Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/net/URLRequest.html