Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flash.events 

DataEvent  - AS3

Пакетflash.events
Классpublic class DataEvent
НаследованиеDataEvent Inheritance TextEvent Inheritance Event Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Объект отправляет объект DataEvent при завершении загрузки необработанных данных. Существует два типа события данных:
  • DataEvent.DATA: отправляется для отправленных или полученных данных;
  • DataEvent.UPLOAD_COMPLETE_DATA: отправляется, когда данные отправлены и ответил сервер.

Посмотреть примеры

Связанные элементы API



Общедоступные свойства
 СвойствоОпределено
 Inheritedbubbles : Boolean
[только для чтения] Определяет, является ли событие событием восходящей цепочки.
Event
 Inheritedcancelable : Boolean
[только для чтения] Указывает, можно ли предотвратить поведение, связанное с событием.
Event
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcurrentTarget : Object
[только для чтения] Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
Event
  data : String
Необработанные данные, загружаемые в Flash Player или Adobe AIR.
DataEvent
 InheritedeventPhase : uint
[только для чтения] Текущая фаза в потоке событий.
Event
 Inheritedtarget : Object
[только для чтения] Целевой объект события.
Event
 Inheritedtext : String
Для события textInput — введенный пользователем знак или последовательность знаков.
TextEvent
 Inheritedtype : String
[только для чтения] Тип события.
Event
Общедоступные методы
 МетодОпределено
  
DataEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, data:String = "")
Создает объект Event, содержащий информацию о событиях data.
DataEvent
  
[переопределить] Создает копию объекта DataEvent и задает значение каждого свойства, совпадающее с оригиналом.
DataEvent
 Inherited
formatToString(className:String, ... arguments):String
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.
Event
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Проверяет, выполнялся ли для события вызова метода preventDefault().
Event
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Отменяет поведение по умолчанию для события, если такое поведение можно отменить.
Event
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.
Event
 Inherited
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.
Event
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
  
[переопределить] Возвращает строку, содержащую все свойства объекта DataEvent.
DataEvent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Общедоступные константы
 КонстантаОпределено
  DATA : String = "data"
[статические] Определяет значение свойства type объекта события data.
DataEvent
  UPLOAD_COMPLETE_DATA : String = "uploadCompleteData"
[статические] Определяет значение свойства type объекта события uploadCompleteData.
DataEvent
Сведения о свойстве

data

свойство
data:String

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Необработанные данные, загружаемые в Flash Player или Adobe AIR.



Реализация
    public function get data():String
    public function set data(value:String):void
Сведения о конструкторе

DataEvent

()Конструктор
public function DataEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, data:String = "")

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Создает объект Event, содержащий информацию о событиях data. Объекты Event передаются прослушивателям событий в качестве параметров.

Параметры
type:String — Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события данных: DataEvent.DATA.
 
bubbles:Boolean (default = false) — Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles.
 
cancelable:Boolean (default = false) — Определяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable.
 
data:String (default = "") — Необработанные данные, загружаемые в Flash Player или Adobe AIR. Прослушиватели событий могут получать эту информацию через свойство data.

Связанные элементы API

Сведения о методе

clone

()метод
override public function clone():Event

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Создает копию объекта DataEvent и задает значение каждого свойства, совпадающее с оригиналом.

Возвращает
Event — Новый объект DataEvent, значения свойств которого соответствуют значениям оригинала.

toString

()метод 
override public function toString():String

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Возвращает строку, содержащую все свойства объекта DataEvent. Строка имеет следующий формат:

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

Возвращает
String — Строка, содержащая все свойства объекта DataEvent.
Сведения о константе

DATA

Константа
public static const DATA:String = "data"

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Определяет значение свойства type объекта события data.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataНеобработанные данные, загружаемые в Flash Player или Adobe AIR.
targetОбъект XMLSocket, получающий данные.

Связанные элементы API

UPLOAD_COMPLETE_DATA

Константа 
public static const UPLOAD_COMPLETE_DATA:String = "uploadCompleteData"

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4

Определяет значение свойства type объекта события uploadCompleteData.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataНеобработанные данные, возвращенные сервером после успешной отправки файла.
targetОбъект FileReference, получающий данные после успешной отправки.

Связанные элементы API

DataEventExample.as

В следующем примере создается объект XMLSocket и подключается к серверу сокетов с портом 8080 домена yourDomain. К объекту XMLSocket добавляется прослушиватель событий data, отправляемых при получении необработанных данных.

Примечания.

  • Чтобы генерировать событие securityError в данном примере, необходимо компилировать SWF-файл с настройкой «Безопасность локального воспроизведения» в значении «Доступ только к сети».
  • Потребуется сервер на домене [yourDomain], использующий порт 8080.

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 ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.