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

SecurityErrorEvent  - AS3

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

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

Объект отправляет объект SecurityErrorEvent, чтобы сообщить об ошибке безопасности. Ошибки безопасности, о которых сообщается с помощью этого класса, обычно происходят в результате выполнения асинхронных операций, таких как загрузка данных, при которых нарушения политики безопасности могут выявляться в некоторой задержкой. Прослушиватель событий может обратиться к свойству text объекта, чтобы определить, какая предпринималась операция, и вовлеченные URL. Если прослушивателей событий нет, отладочная версия Flash Player или приложение AIR Debug Launcher (ADL) автоматически отображает сообщение об ошибке с содержимым свойства text. Существует один тип события ошибки безопасности: SecurityErrorEvent.SECURITY_ERROR.

События ошибки безопасности — это окончательные события, отправляемые для целевого объекта. Это значит, что для целевого объекта, столкнувшегося с ошибкой безопасности, другие события, включая события общих ошибок, не отправляются.

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

Связанные элементы 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
Общедоступные методы
 МетодОпределено
  
SecurityErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Создает объект Event, содержащий сведения о событиях ошибки безопасности.
SecurityErrorEvent
  
[переопределить] Создает копию объекта SecurityErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.
SecurityErrorEvent
 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
  
[переопределить] Возвращает строку, содержащую все свойства объекта SecurityErrorEvent.
SecurityErrorEvent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Общедоступные константы
 КонстантаОпределено
  SECURITY_ERROR : String = "securityError"
[статические] Константа SecurityErrorEvent.SECURITY_ERROR определяет значение свойства type для объекта события securityError.
SecurityErrorEvent
Сведения о конструкторе

SecurityErrorEvent

()Конструктор
public function SecurityErrorEvent(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, содержащий сведения о событиях ошибки безопасности. Объекты Event передаются прослушивателям событий в качестве параметров.

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

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

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

clone

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

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

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

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

toString

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

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

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

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

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

SECURITY_ERROR

Константа
public static const SECURITY_ERROR:String = "securityError"

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

Константа SecurityErrorEvent.SECURITY_ERROR определяет значение свойства type для объекта события securityError.

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

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

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

SecurityErrorEventExample.as

В следующем примере используется класс SecurityErrorEventExample, чтобы продемонстрировать создание метода прослушивателя securityErrorHandler() и его использование для прослушивания отправляемых событий securityError. Это событие происходит, когда объект URLRequest находится не в том же домене, что и вызывающий SWF-файл, и запрашиваемому домену не предоставлено право доступа с помощью файла политики междоменного доступа.

Чтобы создать SecurityErrorEvent, замените http://www.[yourDomain].com путем, не авторизованным для междоменного доступа.

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

    public class SecurityErrorEventExample extends Sprite {
        public function SecurityErrorEventExample() {
            var loader:URLLoader = new URLLoader();
            loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);

            var request:URLRequest = new URLRequest("http://www.[yourDomain].com");
            loader.load(request);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }
    }
}




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

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