Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
flash.net 

NetworkInfo  - AS3

Packageflash.net
Classepublic class NetworkInfo
HéritageNetworkInfo Inheritance EventDispatcher Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

La classe NetworkInfo fournit des informations sur les interfaces réseau d’un ordinateur.

Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur tous les systèmes d’exploitation de bureau et les périphériques AIR pour TV, mais ne l’est pas sur tous les périphériques mobiles. Vous pouvez tester la prise en charge lors de l’exécution à l’aide de la propriété NetworkInfo.isSupported. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.

L’objet NetworkInfo est un singleton. Pour obtenir l’objet NetworkInfo, utilisez la propriété statique NetworkInfo.networkInfo. N’appelez pas le constructeur de la classe new NetworkInfo().

La plupart des ordinateurs disposent d’une ou de plusieurs interfaces, par exemple d’une interface réseau sans fil et d’une interface réseau câblée. D’autres interfaces peuvent être présentes : VPN, interface de bouclage, interfaces virtuelles, etc.

Un objet NetworkInfo distribue un événement change lorsque les interfaces disponibles changent. Appelez la méthode findInterfaces() pour obtenir les informations les plus récentes concernant le réseau.

Remarque : l’objet NativeApplication distribue également des événements de changement réseau.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
      isSupported : Boolean
[statique] [lecture seule] Indique si l’accès aux informations de l’interface réseau est pris en charge sur le système client.
NetworkInfo
      networkInfo : NetworkInfo
[statique] [lecture seule] Occurrence singleton de l’objet NetworkInfo.
NetworkInfo
      permissionStatus : String
[statique] [lecture seule] Déterminez si l’application a été autorisée à accéder à NetworkInfo.
NetworkInfo
Méthodes publiques
 MéthodeDéfini par
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.
EventDispatcher
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
  
Renvoie la liste des interfaces réseau associées à la machine.
NetworkInfo
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.
EventDispatcher
Evénements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.EventDispatcher
  Distribué lorsque les interfaces réseau ont changé.NetworkInfo
Détails de la propriété
    

isSupported

propriété
isSupported:Boolean  [lecture seule]

Versions du moteur d’exécution: AIR 2

Indique si l’accès aux informations de l’interface réseau est pris en charge sur le système client.



Implémentation
    public static function get isSupported():Boolean
    

networkInfo

propriété 
networkInfo:NetworkInfo  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Occurrence singleton de l’objet NetworkInfo.



Implémentation
    public static function get networkInfo():NetworkInfo

Valeur émise
SecurityError — Indique si le contenu s’exécutant hors du sandbox de sécurité de l’application AIR accède à cette propriété.
    

permissionStatus

propriété 
permissionStatus:String  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 29.0

Déterminez si l’application a été autorisée à accéder à NetworkInfo.



Implémentation
    public static function get permissionStatus():String

Eléments de l’API associés

Détails de la méthode

    findInterfaces

()méthode
public function findInterfaces():Vector.<NetworkInterface>

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Renvoie la liste des interfaces réseau associées à la machine.

Valeur renvoyée
Vector.<NetworkInterface> — Tableau d’objets NetworkInterface.
Détails de l’événement
    

networkChange

Evénement
Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.NETWORK_CHANGE

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 2

Distribué lorsque les interfaces réseau ont changé.

La constante Event.NETWORK_CHANGE définit la valeur de la propriété type d’un objet événement networkChange.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetL’objet NativeApplication.




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.