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

Error  - AS3

ПакетВерхний уровень
Классpublic dynamic class Error
НаследованиеError Inheritance Object
Подклассы ArgumentError, AugmentedError, AutomationError, CollectionViewError, ComplexCyclicDependencyError, Conflict, ConstraintError, CursorError, DataServiceError, DefinitionError, DRMManagerError, EvalError, ExpressionError, ExpressionEvaluationError, ExpressionValidationError, Fault, FormBridgeError, FunctionSequenceError, IllegalOperationError, InvalidCategoryError, InvalidFilterError, InvalidSWFError, IOError, ItemPendingError, MediaError, MemoryError, MessagingError, MetricError, NoDataAvailableError, PermissionError, PersistenceError, PersistenceError, ProxyServiceError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, SimpleCyclicDependencyError, SortError, SQLError, StackOverflowError, SyncManagerError, SyntaxError, TypeError, UnresolvedConflictsError, URIError, VerifyError, VideoError, VideoError

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

Класс Error содержит информацию об ошибке, возникшей в сценарии. Когда при разработке приложений на языке ActionScript 3.0 скомпилированный код выполняется в отладочной версии среды выполнения Flash, появляется диалоговое окно с исключениями типа Error или подкласса, помогающее устранить ошибки кода. Объект Error создается с помощью функции конструктора Error. Как правило, новый объект Error формируется внутри программного блока try, а затем регистрируется в программном блоке catch.

Кроме того, можно создать подкласс класса Error и генерировать экземпляры этого подкласса.

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



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  errorID : int
[только для чтения] Содержит номер ссылки, связанный с конкретным сообщением об ошибке.
Error
  message : String
Содержит сообщение, связанное с объектом Error.
Error
  name : String
Содержит имя объекта Error.
Error
Общедоступные методы
 МетодОпределено
  
Error(message:String = "", id:int = 0)
Создает новый объект Error.
Error
  
Возвращает список вызовов для данной ошибки в момент ее конструирования в форме строки.
Error
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
  
[переопределить] Возвращает строку Error по умолчанию или значение, содержащееся в свойстве Error.message, если оно определено.
Error
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве

errorID

свойство
errorID:int  [только для чтения]

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

Содержит номер ссылки, связанный с конкретным сообщением об ошибке. Для пользовательского объекта Error это число является значением параметра id, представленным в конструкторе.



Реализация
    public function get errorID():int

message

свойство 
public var message:String

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

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

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

name

свойство 
public var name:String

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

Содержит имя объекта Error. По умолчанию в качестве значения этого свойства выбрано Error.

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

Сведения о конструкторе

Error

()Конструктор
public function Error(message:String = "", id:int = 0)

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

Создает новый объект Error. Если указано message, его значение присваивается свойству Error.message объекта.

Параметры
message:String (default = "") — Строка, связанная с объектом Error; этот параметр является необязательным.
 
id:int (default = 0) — Ссылочный номер, связываемый с конкретным сообщением об ошибке.

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


Пример  ( Использование этого примера )

В следующем примере создается новый объект Error err, а затем с помощью конструктора Error() строка New Error Message («Новое сообщение об ошибке») присваивается err.
var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message
Сведения о методе

getStackTrace

()метод
public function getStackTrace():String

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

Возвращает список вызовов для данной ошибки в момент ее конструирования в форме строки. Как показано в следующем примере, первая строка возвращаемого значения представляет собой строковое представление объекта исключения, вслед за которой указываются элементы трассировки стека.

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()[/src/com/xyz/OrderEntry.as:995]
         at com.xyz::OrderEntry/init()[/src/com/xyz/OrderEntry.as:200]
         at com.xyz::OrderEntry()[/src/com/xyz/OrderEntry.as:148]
        

В вышеприведенном примере отображается значение этого метода при вызове его в отладочной версии Flash Player или при выполнении кода в AIR Debug Launcher (ADL). При выполнении кода в финальной версии Flash Player или AIR трассировка стека предоставляется без файлового пути и без информации о номере строки, как в следующем примере:

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()
         at com.xyz::OrderEntry/init()
         at com.xyz::OrderEntry()
        

В случае Flash Player 11.4 и более ранних версий или AIR 3.4 и более ранних версий, трассировки стека доступны только при выполнении кода в отладочной версии Flash Player или в AIR Debug Launcher (ADL). В неотладочных версиях этих сред выполнения при вызове этого метода будет возвращено значение null.

Возвращает
String — Строковое представление списка вызовов.

toString

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

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

Возвращает строку Error по умолчанию или значение, содержащееся в свойстве Error.message, если оно определено.

Возвращает
String — Сообщение об ошибке.

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


Пример  ( Использование этого примера )

В следующем примере создается новый объект Error err, а затем с помощью конструктора Error() строка New Error Message («Новое сообщение об ошибке») присваивается err. В итоге, свойству message присваивается значение Another New Error Message («Еще одно новое сообщение об ошибке»), которое заменяет значение New Error Message («Новое сообщение об ошибке»).
var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message

err.message = "Another New Error Message";
trace(err.toString());    // Error: Another New Error Message
ErrorExample.as

В следующем примере используется класс ErrorExample, на примере которого демонстрируется процесс генерации пользовательской ошибки. Это можно сделать, выполнив следующие действия:
  1. Объявляется локальная переменная nullArray типа Array, но обратите внимание, что новый объект Array никогда не создается.
  2. Конструктор пытается загрузить значение в неинициализированный массив методом push() в сегменте кода для обработки ошибок, который перехватывает пользовательскую ошибку с помощью класса CustomError, который является расширением класса Error.
  3. При создании класса CustomError конструктор регистрирует его, а затем выдает сообщение об ошибке с помощью выражения trace().
package
{
    import flash.display.Sprite;
    public class ErrorExample extends Sprite 
    {
        private var nullArray:Array;
        public function ErrorExample() 
        {
            try 
            {
                nullArray.push("item");
            }
            catch(e:Error) 
            {
                throw new CustomError("nullArray is null");
            }
        }
    }
}

class CustomError extends Error 
{
    public function CustomError(message:String) 
    {
        super(message);
    }
}




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

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