Paket | flash.net |
Klasse | public class URLRequestDefaults |
Vererbung | URLRequestDefaults Object |
Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
URLRequestDefaults.setLoginCredentialsForHost()
, mit der Sie Standardauthentifizierungsdetails für Anforderungen definieren können. Die URLRequest-Klasse definiert die Informationen, die in einer HTTP-Anforderung verwendet werden.
Alle in einem URLRequest-Objekt festgelegten Eigenschaften überschreiben diese statischen Eigenschaften, die für die URLRequestDefaults-Klasse festgelegt sind.
URLRequestDefault-Einstellungen gelten nur für Inhalt in der Anwendungsdomäne des Aufrufers, mit einer Ausnahme: Einstellungen, die durch den Aufruf von URLRequestDefaults.setLoginCredentialsForHost()
vorgenommen werden, gelten für alle Anwendungsdomänen in der zurzeit ausgeführten Anwendung.
Nur Adobe® AIR®-Inhalt, der in der Sicherheitssandbox der Anwendung ausgeführt wird, kann die URLRequestDefaults-Klasse verwenden. Andere Inhalte lösen einen SecurityError aus, wenn auf die Mitglieder oder Eigenschaften dieser Klasse zugegriffen wird.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
authenticate : Boolean [statisch]
Die Standardeinstellung für die authenticate-Eigenschaft von URLRequest-Objekten. | URLRequestDefaults | ||
cacheResponse : Boolean [statisch]
Die Standardeinstellung für die cacheResponse-Eigenschaft von URLRequest-Objekten. | URLRequestDefaults | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
followRedirects : Boolean [statisch]
Die Standardeinstellung für die followRedirects-Eigenschaft von URLRequest-Objekten. | URLRequestDefaults | ||
idleTimeout : Number [statisch]
Die Standardeinstellung für die idleTimeout-Eigenschaft des URLRequest-Objekts und des HTMLLoader-Objekts. | URLRequestDefaults | ||
manageCookies : Boolean [statisch]
Die Standardeinstellung für die manageCookies-Eigenschaft von URLRequest-Objekten. | URLRequestDefaults | ||
useCache : Boolean [statisch]
Die Standardeinstellung für die useCache-Eigenschaft von URLRequest-Objekten. | URLRequestDefaults | ||
userAgent : String [statisch]
Die Standardeinstellung für die userAgent-Eigenschaft von URLRequest-Objekten. | URLRequestDefaults |
Methode | Definiert von | ||
---|---|---|---|
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 | ||
[statisch]
Legt Benutzer- und Kennwortdaten für einen ausgewählten Host fest. | URLRequestDefaults | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
authenticate | Eigenschaft |
authenticate:Boolean
Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
Die Standardeinstellung für die authenticate
-Eigenschaft von URLRequest-Objekten. Durch das Festlegen der authenticate
-Eigenschaft in einem URLRequest-Objekt überschreibt diese Standardeinstellung.
Hinweis: Diese Einstellung gilt nicht für URLRequest-Objekte, die bei Datei-Upload- oder RTMP-Anforderungen verwendet werden.
Der Standardwert ist true.
Implementierung
public static function get authenticate():Boolean
public static function set authenticate(value:Boolean):void
Auslöser
SecurityError — Der Aufrufer befindet sich nicht in der Sicherheitssandbox der AIR-Anwendung.
|
Verwandte API-Elemente
cacheResponse | Eigenschaft |
cacheResponse:Boolean
Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
Die Standardeinstellung für die cacheResponse
-Eigenschaft von URLRequest-Objekten. Durch das Festlegen der cacheResponse
-Eigenschaft in einem URLRequest-Objekt überschreibt diese Standardeinstellung. Bei der Einstellung true
verwendet die AIR-Anwendung standardmäßig den HTTP-Cache des Betriebssystems. Diese Einstellung gilt nicht für URLRequest-Objekte, die bei Datei-Upload- oder RTMP-Anforderungen verwendet werden.
Der Standardwert ist true.
Implementierung
public static function get cacheResponse():Boolean
public static function set cacheResponse(value:Boolean):void
Auslöser
SecurityError — Der Aufrufer befindet sich nicht in der Sicherheitssandbox der AIR-Anwendung.
|
Verwandte API-Elemente
followRedirects | Eigenschaft |
followRedirects:Boolean
Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
Die Standardeinstellung für die followRedirects
-Eigenschaft von URLRequest-Objekten. Durch das Festlegen der followRedirects
-Eigenschaft in einem URLRequest-Objekt überschreibt diese Standardeinstellung. Diese Einstellung gilt nicht für URLRequest-Objekte, die bei Datei-Upload- oder RTMP-Anforderungen verwendet werden.
Der Standardwert ist true.
Implementierung
public static function get followRedirects():Boolean
public static function set followRedirects(value:Boolean):void
Auslöser
SecurityError — Der Aufrufer befindet sich nicht in der Sicherheitssandbox der AIR-Anwendung.
|
Verwandte API-Elemente
idleTimeout | Eigenschaft |
idleTimeout:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2 |
Die Standardeinstellung für die idleTimeout
-Eigenschaft des URLRequest-Objekts und des HTMLLoader-Objekts.
Die Leerlaufzeitsperre ist die Zeitspanne (in Millisekunden), die der Client nach dem Herstellen der Verbindung auf eine Antwort vom Server wartet, bevor die Anforderung abgebrochen wird.
Hiermit wird die Standardleerlaufzeitsperre definiert, die vom URLRequest- oder HTMLLoader-Objekt verwendet wird. Durch das Festlegen der idleTimeout
-Eigenschaft in einem URLRequest-Objekt oder einem HTMLLoader-Objekt wird diese Standardeinstellung überschrieben.
Wenn diese Eigenschaft auf 0 (Standardwert) gesetzt ist, verwendet die Laufzeitumgebung den Standardwert für die Leerlaufzeitsperre, die vom Betriebssystem definiert ist. Der Standardwert für die Leerlaufzeitsperre variiert zwischen den verschiedenen Betriebssystemen (z. B. Mac OS, Linux, Windows) und den verschiedenen Versionen der Betriebssysteme.
Diese Einstellung gilt nicht für URLRequest-Objekte, die bei Datei-Upload- oder RTMP-Anforderungen verwendet werden.
Der Standardwert ist 0.
Implementierung
public static function get idleTimeout():Number
public static function set idleTimeout(value:Number):void
Auslöser
SecurityError — Der Aufrufer befindet sich nicht in der Sicherheitssandbox der AIR-Anwendung.
| |
RangeError — Der idleTimeout-Wert ist negativ.
|
Verwandte API-Elemente
manageCookies | Eigenschaft |
manageCookies:Boolean
Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
Die Standardeinstellung für die manageCookies
-Eigenschaft von URLRequest-Objekten. Durch das Festlegen der manageCookies
-Eigenschaft in einem URLRequest-Objekt überschreibt diese Standardeinstellung.
Hinweis: Diese Einstellung gilt nicht für URLRequest-Objekte, die bei Datei-Upload- oder RTMP-Anforderungen verwendet werden.
Der Standardwert ist true.
Implementierung
public static function get manageCookies():Boolean
public static function set manageCookies(value:Boolean):void
Auslöser
SecurityError — Der Aufrufer befindet sich nicht in der Sicherheitssandbox der AIR-Anwendung.
|
Verwandte API-Elemente
useCache | Eigenschaft |
useCache:Boolean
Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
Die Standardeinstellung für die useCache
-Eigenschaft von URLRequest-Objekten. Durch das Festlegen der useCache
-Eigenschaft in einem URLRequest-Objekt überschreibt diese Standardeinstellung. Diese Einstellung gilt nicht für URLRequest-Objekte, die bei Datei-Upload- oder RTMP-Anforderungen verwendet werden.
Der Standardwert ist true.
Implementierung
public static function get useCache():Boolean
public static function set useCache(value:Boolean):void
Auslöser
SecurityError — Der Aufrufer befindet sich nicht in der Sicherheitssandbox der AIR-Anwendung.
|
Verwandte API-Elemente
userAgent | Eigenschaft |
userAgent:String
Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
Die Standardeinstellung für die userAgent
-Eigenschaft von URLRequest-Objekten. Durch das Festlegen der userAgent
-Eigenschaft in einem URLRequest-Objekt überschreibt diese Standardeinstellung.
Dies ist auch der Standard-Benutzer-Agent-String für alle HTMLLoader-Objekte (verwendet, wenn Sie die load()
-Methode des HTMLLoader-Objekts aufrufen). Das Festlegen der userAgent
-Eigenschaft des HTMLLoader-Objekts überschreibt die URLRequestDefaults.userAgent
-Einstellung.
Dieser Standardwert variiert je nach dem Laufzeitbetriebssystem (wie z. B. Mac OS, Linux oder Windows), der Laufzeitsprache und der Laufzeitversion (siehe folgende Beispiele):
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, wie Gecko) AdobeAIR/1.5"
"Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, wie Gecko) AdobeAIR/1.5"
"Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, wie Gecko) AdobeAIR/1.5"
Implementierung
public static function get userAgent():String
public static function set userAgent(value:String):void
Auslöser
SecurityError — Der Aufrufer befindet sich nicht in der Sicherheitssandbox der AIR-Anwendung.
|
Verwandte API-Elemente
setLoginCredentialsForHost | () | Methode |
public static function setLoginCredentialsForHost(hostname:String, user:String, password:String):*
Laufzeitversionen: | AIR 1.0, Flash Lite 4 |
Legt Benutzer- und Kennwortdaten für einen ausgewählten Host fest. Diese Einstellungen beziehen sich auf URLRequest-Objekte in allen Anwendungsdomänen der Anwendung, also nicht nur auf die in der Anwendungsdomäne des Objekts, das diese Methode aufruft (die statischen Eigenschaften der URLRequest-Klasse beziehen sich im Gegensatz hierzu nur auf die Anwendungsdomäne des Aufrufers). Auf diese Weise kann Inhalt in der gesamten Anwendung (unabhängig von der Anwendungsdomäne des Inhalts) angemeldet sein, wenn ein anderer Teil der Anmeldung angemeldet wird.
Hinweis für Anwendungen, die unter Mac OS ausgeführt werden: Wenn Sie diese Methode unter Mac OS aufrufen, verwendet die Anwendung diese Anmeldedaten für den angegebenen Host, bis die Anwendung geschlossen wird, selbst wenn Sie anschließend URLRequestDefaults.setLoginCredentialsForHost()
für den gleichen Host aufrufen. Wenn ein Server jedoch die von dieser Methode angegebenen Anmeldedaten ablehnt, werden nachfolgende Aufrufe der URLRequestDefaults.setLoginCredentialsForHost()
-Methode (für denselben Host) erkannt.
Hinweis: Diese Methode gilt nicht für URLRequest-Objekte, die bei Datei-Upload- oder RTMP-Anforderungen verwendet werden.
Parameter
hostname:String — Der Hostname, auf den der Benutzername und das Kennwort angewendet werden. Dies kann eine Domäne sein, zum Beispiel "www.example.com" oder eine Domäne und eine Portnummer, zum Beispiel "www.example.com:80" . Beachten Sie, dass "example.com" , "www.example.com" und "sales.example.com" jeweils als eindeutige Hosts angesehen werden.
| |
user:String — Der Standardbenutzername, der bei Anforderungsauthentifizierungen für den angegebenen Host verwendet wird.
| |
password:String — Das Standardkennwort, das bei Anforderungsauthentifizierungen für den angegebenen Host verwendet wird.
|
* |
Auslöser
SecurityError — Der Aufrufer befindet sich nicht in der Sicherheitssandbox der AIR-Anwendung.
|
Tue Jun 12 2018, 10:04 AM Z