Package | flash.net |
Classe | public class URLRequestDefaults |
Héritage | URLRequestDefaults Object |
Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
URLRequestDefaults.setLoginCredentialsForHost()
, qui vous permet de définir les informations d’authentification par défaut des requêtes. La classe URLRequest définit les informations devant être utilisées dans une requête HTTP.
Les propriétés définies dans un objet URLRequest remplacent les propriétés statiques définies pour la classe URLRequestDefaults.
Les paramètres de la classe URLRequestDefault ne s’appliquent qu’au contenu du domaine d’application de l’appelant, à une exception près : les paramètres définis lors de l’appel de URLRequestDefaults.setLoginCredentialsForHost()
s’appliquent à tous les domaines d’application dans l’application en cours d’exécution.
Seul le contenu Adobe® AIR® s’exécutant dans le sandbox de sécurité de l’application peut utiliser la classe URLRequestDefaults. L’utilisation d’autres contenus renvoie une exception SecurityError lors de l’accès aux membres ou aux propriétés de cette classe.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
authenticate : Boolean [statique]
Paramètre par défaut de la propriété authenticate des objets URLRequest. | URLRequestDefaults | ||
cacheResponse : Boolean [statique]
Paramètre par défaut de la propriété cacheResponse des objets URLRequest. | URLRequestDefaults | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
followRedirects : Boolean [statique]
Paramètre par défaut de la propriété followRedirects des objets URLRequest. | URLRequestDefaults | ||
idleTimeout : Number [statique]
Paramètre par défaut de la propriété idleTimeout des objets URLRequest et des objets HTMLLoader. | URLRequestDefaults | ||
manageCookies : Boolean [statique]
Paramètre par défaut de la propriété manageCookies des objets URLRequest. | URLRequestDefaults | ||
useCache : Boolean [statique]
Paramètre par défaut de la propriété useCache des objets URLRequest. | URLRequestDefaults | ||
userAgent : String [statique]
Paramètre par défaut de la propriété userAgent des objets URLRequest. | URLRequestDefaults |
Méthode | Défini par | ||
---|---|---|---|
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
[statique]
Définit le nom d’utilisateur et le mot de passe par défaut de l’hôte sélectionné. | URLRequestDefaults | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
authenticate | propriété |
authenticate:Boolean
Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Paramètre par défaut de la propriété authenticate
des objets URLRequest. La définition de la propriété authenticate
dans un objet URLRequest annule ce paramètre par défaut.
Remarque : ce paramètre ne s’applique pas aux objets URLRequest utilisés lors du chargement de fichiers ou dans des requêtes RTMP.
La valeur par défaut est true.
Implémentation
public static function get authenticate():Boolean
public static function set authenticate(value:Boolean):void
Valeur émise
SecurityError — L’appelant ne se trouve pas dans le sandbox de sécurité de l’application AIR.
|
Eléments de l’API associés
cacheResponse | propriété |
cacheResponse:Boolean
Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Paramètre par défaut de la propriété cacheResponse
des objets URLRequest. La définition de la propriété cacheResponse
dans un objet URLRequest annule ce paramètre par défaut. Si la valeur correspond à true
, l’application AIR utilise par défaut le cache HTTP du système d’exploitation. Ce paramètre ne s’applique pas aux objets URLRequest utilisés lors du chargement de fichiers ou dans des requêtes RTMP.
La valeur par défaut est true.
Implémentation
public static function get cacheResponse():Boolean
public static function set cacheResponse(value:Boolean):void
Valeur émise
SecurityError — L’appelant ne se trouve pas dans le sandbox de sécurité de l’application AIR.
|
Eléments de l’API associés
followRedirects | propriété |
followRedirects:Boolean
Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Paramètre par défaut de la propriété followRedirects
des objets URLRequest. La définition de la propriété followRedirects
dans un objet URLRequest annule ce paramètre par défaut. Ce paramètre ne s’applique pas aux objets URLRequest utilisés lors du chargement de fichiers ou dans des requêtes RTMP.
La valeur par défaut est true.
Implémentation
public static function get followRedirects():Boolean
public static function set followRedirects(value:Boolean):void
Valeur émise
SecurityError — L’appelant ne se trouve pas dans le sandbox de sécurité de l’application AIR.
|
Eléments de l’API associés
idleTimeout | propriété |
idleTimeout:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 2 |
Paramètre par défaut de la propriété idleTimeout
des objets URLRequest et des objets HTMLLoader.
Le délai d’inactivité correspond au laps de temps (en millisecondes) que le client attend une réponse du serveur, une fois la connexion établie et avant l’abandon de la requête.
Ce paramètre définit le délai d’inactivité par défaut utilisé par l’objet URLRequest ou par l’objet HTMLLoader. La définition de la propriété idleTimeout
dans un objet URLRequest ou un objet HTMLLoader annule ce paramètre par défaut.
Lorsque cette propriété est définie sur 0 (valeur par défaut), le moteur d’exécution utilise le délai d’inactivité par défaut défini par le système d’exploitation. Le délai d’inactivité par défaut varie selon le système d’exploitation (Mac OS, Linux ou Windows) ou selon la version du système d’exploitation.
Ce paramètre ne s’applique pas aux objets URLRequest utilisés lors du chargement de fichiers ou dans des requêtes RTMP.
La valeur par défaut est 0.
Implémentation
public static function get idleTimeout():Number
public static function set idleTimeout(value:Number):void
Valeur émise
SecurityError — L’appelant ne se trouve pas dans le sandbox de sécurité de l’application AIR.
| |
RangeError — La valeur idleTimeout est négative.
|
Eléments de l’API associés
manageCookies | propriété |
manageCookies:Boolean
Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Paramètre par défaut de la propriété manageCookies
des objets URLRequest. La définition de la propriété manageCookies
dans un objet URLRequest annule ce paramètre par défaut.
Remarque : ce paramètre ne s’applique pas aux objets URLRequest utilisés lors du chargement de fichiers ou dans des requêtes RTMP.
La valeur par défaut est true.
Implémentation
public static function get manageCookies():Boolean
public static function set manageCookies(value:Boolean):void
Valeur émise
SecurityError — L’appelant ne se trouve pas dans le sandbox de sécurité de l’application AIR.
|
Eléments de l’API associés
useCache | propriété |
useCache:Boolean
Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Paramètre par défaut de la propriété useCache
des objets URLRequest. La définition de la propriété useCache
dans un objet URLRequest annule ce paramètre par défaut. Ce paramètre ne s’applique pas aux objets URLRequest utilisés lors du chargement de fichiers ou dans des requêtes RTMP.
La valeur par défaut est true.
Implémentation
public static function get useCache():Boolean
public static function set useCache(value:Boolean):void
Valeur émise
SecurityError — L’appelant ne se trouve pas dans le sandbox de sécurité de l’application AIR.
|
Eléments de l’API associés
userAgent | propriété |
userAgent:String
Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Paramètre par défaut de la propriété userAgent
des objets URLRequest. La définition de la propriété userAgent
dans un objet URLRequest annule ce paramètre par défaut.
Il s’agit également de la chaîne userAgent par défaut de tous les objets HTMLLoader (utilisés lors de l’appel de la méthode load()
de l’objet HTMLLoader). La définition de la propriété userAgent
de l’objet HTMLLoader annule le paramètre URLRequestDefaults.userAgent
.
Cette valeur par défaut varie selon le système d’exploitation du moteur d’exécution (par exemple, Mac OS, Linux ou Windows), ainsi que du langage et de la version du moteur d’exécution, comme le montrent les exemples suivants :
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
"Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
"Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
Implémentation
public static function get userAgent():String
public static function set userAgent(value:String):void
Valeur émise
SecurityError — L’appelant ne se trouve pas dans le sandbox de sécurité de l’application AIR.
|
Eléments de l’API associés
setLoginCredentialsForHost | () | méthode |
public static function setLoginCredentialsForHost(hostname:String, user:String, password:String):*
Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
Définit le nom d’utilisateur et le mot de passe par défaut de l’hôte sélectionné. Ces paramètres s’appliquent aux objets URLRequest dans tous les domaines d’application de l’application, pas seulement à ceux du domaine d’application de l’objet appelant cette méthode (tandis que les propriétés statiques de la classe URLRequest s’appliquent uniquement au domaine d’application de l’appelant). Ceci permet une connexion au contenu de l’application (quel que soit le domaine d’application du contenu) lorsqu’une autre partie de l’application se connecte.
Remarque concernant les applications fonctionnant sous Mac OS : lorsque vous appelez cette méthode sous Mac OS, l’application utilise ces informations d’identification pour l’hôte spécifié tant que celle-ci est ouverte, même si vous appelez par la suite la méthode URLRequestDefaults.setLoginCredentialsForHost()
pour le même hôte. Cependant, si un serveur rejette les informations d’identification spécifiées par cette méthode, l’appel suivant à la méthode URLRequestDefaults.setLoginCredentialsForHost()
(pour le même hôte) est reconnu.
Remarque : cette méthode ne s’applique pas aux objets URLRequest utilisés lors du chargement de fichiers ou dans des requêtes RTMP.
Paramètres
hostname:String — Le nom d’hôte auxquels sont appliqués le nom d’utilisateur et le mot de passe. Il peut s’agir d’un domaine, tel que "www.example.com" , ou d’un nom de domaine et d’un numéro de port, par exemple "www.example.com:80" . Notez que "example.com" , "www.example.com" et "sales.example.com" sont considérés comme hôtes uniques.
| |
user:String — Nom d’utilisateur par défaut à utiliser lors de l’authentification d’une requête pour l’hôte spécifié.
| |
password:String — Mot de passe par défaut à utiliser lors de l’authentification d’une requête pour l’hôte spécifié.
|
* |
Valeur émise
SecurityError — L’appelant ne se trouve pas dans le sandbox de sécurité de l’application AIR.
|
Tue Jun 12 2018, 09:30 AM Z