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.events 

DataEvent  - AS3

Paketflash.events
Klassepublic class DataEvent
VererbungDataEvent Inheritance TextEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein Objekt löst ein DataEvent-Objekt aus, wenn Grunddaten fertig geladen wurden. Es gibt zwei Arten von Datenereignissen:
  • DataEvent.DATA: wird bei gesendeten oder empfangenen Daten ausgelöst.
  • DataEvent.UPLOAD_COMPLETE_DATA: wird bei gesendeten Daten oder bei Antwort des Servers ausgelöst.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
  data : String
Die in Flash Player oder Adobe AIR geladenen Grunddaten.
DataEvent
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtext : String
Bei einem textInput-Ereignis das bzw. die vom Benutzer eingegebene(n) Zeichen.
TextEvent
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
DataEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, data:String = "")
Erstellt ein Ereignisobjekt, das Informationen über Datenereignisse enthält.
DataEvent
  
[override] Erstellt eine Kopie des DataEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
DataEvent
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
[override] Gibt eine Zeichenfolge zurück, die alle Eigenschaften des DataEvent-Objekts enthält.
DataEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  DATA : String = "data"
[statisch] Definiert den Wert der Eigenschaft type eines Datenereignisobjekts.
DataEvent
  UPLOAD_COMPLETE_DATA : String = "uploadCompleteData"
[statisch] Definiert den Wert der Eigenschaft type eines uploadCompleteData-Ereignisobjekts.
DataEvent
Eigenschaftendetails

data

Eigenschaft
data:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die in Flash Player oder Adobe AIR geladenen Grunddaten.



Implementierung
    public function get data():String
    public function set data(value:String):void
Konstruktordetails

DataEvent

()Konstruktor
public function DataEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, data:String = "")

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt ein Ereignisobjekt, das Informationen über Datenereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.

Parameter
type:String — Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ eines Datenereignisses: DataEvent.DATA.
 
bubbles:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen.
 
cancelable:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen.
 
data:String (default = "") — Die in Flash Player oder Adobe AIR geladenen Grunddaten. Ereignis-Listener können über die Eigenschaft data auf diese Informationen zugreifen.

Verwandte API-Elemente

Methodendetails

clone

()Methode
override public function clone():Event

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt eine Kopie des DataEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.

Rückgabewerte
Event — Ein neues DataEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.

toString

()Methode 
override public function toString():String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt eine Zeichenfolge zurück, die alle Eigenschaften des DataEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[DataEvent type=Wert bubbles=Wert cancelable=Wert data=Wert]

Rückgabewerte
String — Eine Zeichenfolge, die alle Eigenschaften des DataEvent-Objekts enthält.
Konstantendetails

DATA

Konstante
public static const DATA:String = "data"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Definiert den Wert der Eigenschaft type eines data-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.
dataDie in Flash Player oder Adobe AIR geladenen Grunddaten.
targetDas XMLSocket-Objekt, das Daten empfängt.

Verwandte API-Elemente

UPLOAD_COMPLETE_DATA

Konstante 
public static const UPLOAD_COMPLETE_DATA:String = "uploadCompleteData"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4

Definiert den Wert der Eigenschaft type eines uploadCompleteData-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.
dataDie unformatierten Daten, die nach einem erfolgreichen Datei-Upload vom Server zurückgegeben werden.
targetDas FileReference-Objekt, das nach einem erfolgreichen Upload Daten empfängt.

Verwandte API-Elemente

DataEventExample.as

Im folgenden Beispiel wird ein XMLSocket erstellt und eine Verbindung mit einem Socket-Server an Port 8080 von yourDomain hergestellt. Dem XMLSocket-Objekt wird ein Ereignis-Listener zugewiesen, der auf data-Ereignisse wartet. Diese Ereignisse werden beim Empfang von unformatierten Daten ausgelöst.

Hinweise:

  • Um in diesem Beispiel ein securityError-Ereignis zu generieren, müssen Sie „Sicherheit bei lokaler Wiedergabe“ auf „Nur auf Netzwerk zugreifen“ setzen, um die SWF-Datei zu kompilieren.
  • Sie benötigen einen Server, der auf [ yourDomain ] ausgeführt wird und über Port 8080 angeschlossen ist.

package {
    import flash.display.Sprite;
    import flash.events.DataEvent;
    import flash.net.XMLSocket;

    public class DataEventExample extends Sprite {
        private var hostName:String = "[yourDomain]";
        private var port:uint = 8080;
        private var socket:XMLSocket;

        public function DataEventExample() {
            socket = new XMLSocket();
            socket.addEventListener(DataEvent.DATA, dataHandler);
            socket.connect(hostName, port);
        }

        private function dataHandler(event:DataEvent):void {
            trace("dataHandler: " + event.data);
        }
    }
}




[ 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.