| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Error. Как правило, новый объект Error создается из кодового блока try, данные из которого поступают в кодовый блок catch или finally.
Кроме того, можно создать подкласс класса Error и генерировать экземпляры этого подкласса.
Дополнительные примеры
Использование инструкций try..catch..finally
Создание пользовательских классов ошибок
Ответы на события ошибок и ошибки состояния
Пример обработки ошибок: программа CustomErrors
Дополнительно
Обработка ошибок в ActionScript 3.0
Элементы обработки ошибок в ActionScript 3.0
Стратегия обработки ошибок
Сравнение классов ошибок
Базовые классы Error
| Свойство | Определено | ||
|---|---|---|---|
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| errorID : int [только для чтения]
Содержит номер ссылки, связанный с конкретным сообщением об ошибке. | Error | ||
| message : String
Содержит сообщение, связанное с объектом Error. | Error | ||
| name : String
Содержит имя объекта Error. | Error | ||
![]() | prototype : Object [статические]
Ссылка на модель объекта класса или функции. | Object | |
| Метод | Определено | ||
|---|---|---|---|
Создает новый объект Error. | Error | ||
Возвращает стек вызовов для ошибки в виде строки при конструировании ошибки (только для отладочных версий Flash Player и AIR Debug Launcher (ADL); возвращает null, если не используются отладочные версии Flash Player или ADL). | Error | ||
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
[переопределить]
Возвращает строку Error по умолчанию или значение, содержащееся в свойстве Error.message, если оно определено. | Error | ||
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
errorID | свойство |
errorID:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Содержит номер ссылки, связанный с конкретным сообщением об ошибке. Для пользовательского объекта Error это число является значением параметра id, представленным в конструкторе.
Реализация
public function get errorID():intmessage | свойство |
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
Пример ( Использование этого примера )
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 |
Возвращает стек вызовов для ошибки в виде строки при конструировании ошибки (только для отладочных версий Flash Player и AIR Debug Launcher (ADL); возвращает null, если не используются отладочные версии Flash Player или ADL). Как показано в следующем примере, первая строка возвращаемого значения представляет собой строковое представление объекта исключения, вслед за которой указываются элементы трассировки стека.
TypeError: null cannot be converted to an object
at com.xyz.OrderEntry.retrieveData(OrderEntry.as:995)
at com.xyz.OrderEntry.init(OrderEntry.as:200)
at com.xyz.OrderEntry.$construct(OrderEntry.as:148)
String — Строковое представление списка вызовов.
|
toString | () | метод |
override public function toString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Возвращает строку Error по умолчанию или значение, содержащееся в свойстве Error.message, если оно определено.
String — Сообщение об ошибке.
|
Связанные элементы API
Пример ( Использование этого примера )
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, на примере которого демонстрируется процесс генерации пользовательской ошибки. Это можно сделать, выполнив следующие действия:
- Объявляется локальная переменная
nullArrayтипа Array, но обратите внимание, что новый объект Array никогда не создается. - Конструктор пытается загрузить значение в неинициализированный массив методом
push()в сегменте кода для обработки ошибок, который перехватывает пользовательскую ошибку с помощью классаCustomError, который является расширением классаError. - При создании класса 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);
}
}
Wed Apr 11 2012, 05:48 AM -07:00
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства