ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.net 

NetworkInfo  - AS3

Paketflash.net
Klassepublic class NetworkInfo
VererbungNetworkInfo Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2

Die NetworkInfo-Klasse stellt Informationen zu den Netzwerkschnittstellen eines Computers bereit.

Unterstützung von AIR-Profilen: Diese Funktion wird unter allen Desktopbetriebssystemen und auf Geräten mit AIR für TV unterstützt, jedoch nicht auf mobilen Geräten. Mit der NetworkInfo.isSupported-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum API-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.

Das NetworkInfo-Objekt ist ein Singleton. Um das einzelne NetworkInfo-Objekt abzurufen, verwenden Sie die NetworkInfo.networkInfo-Eigenschaft. Rufen Sie nicht den Klassenkonstruktor, new NetworkInfo(), auf.

Die meisten Computer verfügen über eine oder mehrere Schnittstellen, zum Beispiel eine kabelgebundene und eine drahtlose Netzwerkschnittstelle. Möglicherweise gib es noch weitere Schnittstellen wie VPN-, Loopback- oder virtuelle Schnittstellen.

Ein NetworkInfo-Objekt setzt ein Wechselereignis ab, wenn die verfügbaren Schnittstellen geändert werden. Rufen Sie die findInterfaces()-Methode auf, um die aktuellen Netzwerkinformationen anzuzeigen.

Hinweis: Das NativeApplication-Objekt setzt auch Netzwerkänderungsereignisse ab.

Weitere Informationen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
      isSupported : Boolean
[statisch] [schreibgeschützt] Gibt an, das Clientsystem den Zugriff auf Netzwerkschnittstelleninformationen unterstützt.
NetworkInfo
      networkInfo : NetworkInfo
[statisch] [schreibgeschützt] Die Singleton-Instanz des NetworkInfo-Objekts.
NetworkInfo
      permissionStatus : String
[statisch] [schreibgeschützt] Bestimmen Sie, ob der Anwendung die Berechtigung zum Zugriff auf NetworkInfo erteilt wurde.
NetworkInfo
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
Gibt die Liste der Netzwerkschnittstellen zurück, mit diesem Computer verknüpft sind.
NetworkInfo
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
  Wird abgesetzt, wenn sich die Netzwerkschnittstellen geändert haben.NetworkInfo
Eigenschaftendetails
    

isSupported

Eigenschaft
isSupported:Boolean  [schreibgeschützt]

Laufzeitversionen: AIR 2

Gibt an, das Clientsystem den Zugriff auf Netzwerkschnittstelleninformationen unterstützt.



Implementierung
    public static function get isSupported():Boolean
    

networkInfo

Eigenschaft 
networkInfo:NetworkInfo  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2

Die Singleton-Instanz des NetworkInfo-Objekts.



Implementierung
    public static function get networkInfo():NetworkInfo

Auslöser
SecurityError — Wenn Inhalt, der außerhalb der Sicherheitssandbox der AIR-Anwendung ausgeführt wird, auf diese Eigenschaft zugreift.
    

permissionStatus

Eigenschaft 
permissionStatus:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 29.0

Bestimmen Sie, ob der Anwendung die Berechtigung zum Zugriff auf NetworkInfo erteilt wurde.



Implementierung
    public static function get permissionStatus():String

Verwandte API-Elemente

Methodendetails

    findInterfaces

()Methode
public function findInterfaces():Vector.<NetworkInterface>

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2

Gibt die Liste der Netzwerkschnittstellen zurück, mit diesem Computer verknüpft sind.

Rückgabewerte
Vector.<NetworkInterface> — Ein Array von NetworkInterface- Objekten
Ereignisdetails
    

networkChange

Ereignis
Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.NETWORK_CHANGE

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2

Wird abgesetzt, wenn sich die Netzwerkschnittstellen geändert haben.

Die Event.NETWORK_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines networkChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas NativeApplication-Objekt.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.