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

IOErrorEvent  - AS3

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

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

Объект IOErrorEvent отправляется, когда операция ввода или вывода завершается с ошибкой.

Проверять события ошибки, для которых нет прослушивателей, можно с помощью отладочной версии Flash Player или приложения AIR Debug Launcher (ADL). Отображается строка, заданная параметром text конструктора IOErrorEvent.

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

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



Общедоступные свойства
 СвойствоОпределено
 Inheritedbubbles : Boolean
[только для чтения] Определяет, является ли событие событием восходящей цепочки.
Event
 Inheritedcancelable : Boolean
[только для чтения] Указывает, можно ли предотвратить поведение, связанное с событием.
Event
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcurrentTarget : Object
[только для чтения] Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
Event
 InheritederrorID : int
[только для чтения] Содержит ссылочный номер, связанный с конкретной ошибкой.
ErrorEvent
 InheritedeventPhase : uint
[только для чтения] Текущая фаза в потоке событий.
Event
 Inheritedtarget : Object
[только для чтения] Целевой объект события.
Event
 Inheritedtext : String
Для события textInput — введенный пользователем знак или последовательность знаков.
TextEvent
 Inheritedtype : String
[только для чтения] Тип события.
Event
Общедоступные методы
 МетодОпределено
  
IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Создает объект Event, содержащий данные о событиях ioError.
IOErrorEvent
  
[переопределить] Создает копию объекта IOErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.
IOErrorEvent
 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
  
[переопределить] Возвращает строку, содержащую все свойства объекта IOErrorEvent.
IOErrorEvent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Общедоступные константы
 КонстантаОпределено
  IO_ERROR : String = "ioError"
[статические] Задает значение свойства type для объекта события ioError.
IOErrorEvent
  STANDARD_ERROR_IO_ERROR : String = "standardErrorIoError"
[статические] Событие standardErrorIoError отправляется, когда возникает ошибка при чтении данных из потока standardError объекта NativeProcess.
IOErrorEvent
  STANDARD_INPUT_IO_ERROR : String = "standardInputIoError"
[статические] Событие standardInputIoError отправляется, когда возникает ошибка при чтении данных из потока standardInput объекта NativeProcess.
IOErrorEvent
  STANDARD_OUTPUT_IO_ERROR : String = "standardOutputIoError"
[статические] Событие standardOutputIoError отправляется, когда возникает ошибка при чтении данных из потока standardOutput объекта NativeProcess.
IOErrorEvent
Сведения о конструкторе

IOErrorEvent

()Конструктор
public function IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)

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

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

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

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

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

clone

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

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

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

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

toString

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

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

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

[IOErrorEvent type=value bubbles=value cancelable=value text=value errorID=value] Свойство errorId доступно только в Adobe AIR.

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

IO_ERROR

Константа
public static const IO_ERROR:String = "ioError"

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

Задает значение свойства type для объекта события ioError.

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

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
errorIDСсылочный номер, связываемый с конкретной ошибкой (только AIR).
targetСетевой объект, с которым произошла ошибка ввода/вывода.
textТекст, отображаемый в качестве сообщения об ошибке.

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

STANDARD_ERROR_IO_ERROR

Константа 
public static const STANDARD_ERROR_IO_ERROR:String = "standardErrorIoError"

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

Событие standardErrorIoError отправляется, когда возникает ошибка при чтении данных из потока standardError объекта NativeProcess.

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

СвойствоЗначение
bubblesНет.
cancelableНет. Нет поведения по умолчанию для отмены.
errorIDСодержит ссылочный номер, связанный с конкретной ошибкой.
targetОбъект, с которым связана ошибка.
textТекст, отображаемый в качестве сообщения об ошибке.

STANDARD_INPUT_IO_ERROR

Константа 
public static const STANDARD_INPUT_IO_ERROR:String = "standardInputIoError"

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

Событие standardInputIoError отправляется, когда возникает ошибка при чтении данных из потока standardInput объекта NativeProcess.

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

СвойствоЗначение
bubblesНет.
cancelableНет. Нет поведения по умолчанию для отмены.
errorIDСодержит ссылочный номер, связанный с конкретной ошибкой.
targetОбъект, с которым связана ошибка.
textТекст, отображаемый в качестве сообщения об ошибке.

STANDARD_OUTPUT_IO_ERROR

Константа 
public static const STANDARD_OUTPUT_IO_ERROR:String = "standardOutputIoError"

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

Событие standardOutputIoError отправляется, когда возникает ошибка при чтении данных из потока standardOutput объекта NativeProcess.

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

СвойствоЗначение
bubblesНет.
cancelableНет. Нет поведения по умолчанию для отмены.
errorIDСодержит ссылочный номер, связанный с конкретной ошибкой.
targetОбъект, с которым связана ошибка.
textТекст, отображаемый в качестве сообщения об ошибке.

IOErrorEventExample.as

В следующем примере используется класс IOErrorEventExample, чтобы продемонстрировать отправку события ошибки при попытке загрузить несуществующий файл. Для этого выполняются следующие задачи:
  1. Конструктор класса создает новый экземпляр объекта URLLoader и назначает его переменной loader.
  2. Экземпляр URLLoader создает прослушиватель событий типа ioError со связанным методом подписчика ioErrorHandler(), который просто печатает сведения о событии с использованием метода trace().
  3. Затем конструктор создает новый экземпляр объекта URLRequest, request, передающий MissingFile.xml, чтобы сообщить имя и местоположение отсутствующего файла.
  4. Затем переменная request передается методу loader.load(), который пытается загрузить отсутствующий файл. Так как файл не существует, обработчик событий отправляет событие ioError.

Примечания.

  • SWF-файл требуется откомпилировать с установленным для параметра «Безопасность локального воспроизведения» режимом «Доступ только к локальным файлам».
  • Проверьте, чтобы не было файла с именем «MissingFile.xml» на одном уровне с SWF-файлом.

package {
    import flash.display.Sprite;
    import flash.events.IOErrorEvent;
    import flash.net.URLLoader;
    import flash.net.URLRequest;

    public class IOErrorEventExample extends Sprite {
        public function IOErrorEventExample() {
            var loader:URLLoader = new URLLoader();
            loader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);

            var request:URLRequest = new URLRequest("MissingFile.xml");
            loader.load(request);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

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