| Пакет | flash.errors |
| Класс | public class SQLError |
| Наследование | SQLError  Error Object |
| Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Когда эта ошибка возникает при выполнении операции базы данных SQL в асинхронном режиме, экземпляр SQLConnection или SQLStatement отправляет объект SQLErrorEvent. Информацию об ошибке в виде экземпляра SQLError можно получить через свойство error объекта SQLErrorEvent.
Когда ошибка возникает при выполнении операции базы данных SQL в синхронном режиме, объект SQLConnection или SQLStatement выдает исключение SQLError, которое можно обработать путем включения кода, вызывающего ошибку в блок try..catch.
Этот класс передает свойства, содержащие сведения об ошибках (указывая конкретный тип возникшей ошибки), текстовое сообщение со сведениями об ошибке и операцию, вызывавшую ее появление.
См. также
| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
 detailArguments : Array[только для чтения]
Массив строковых значений, который используется для создания подробных сообщений об ошибках, предназначенных для конкретного языкового стандарта. | SQLError | ||
| detailID : int [только для чтения]
Ссылочный номер, связанный с конкретным сообщением об ошибке. | SQLError | ||
| details : String [только для чтения]
Сведения о текущей ошибке. | SQLError | ||
| errorID : int [только для чтения]
Содержит номер ссылки, связанный с конкретным сообщением об ошибке. | Error | |
| message : String
Содержит сообщение, связанное с объектом Error. | Error | |
| name : String
Содержит имя объекта Error. | Error | |
| operation : String [только для чтения]
Значение, указывающее операцию, которая была предпринята, когда появилась ошибка. | SQLError | ||
| prototype : Object [статические]
Ссылка на модель объекта класса или функции. | Object | |
| Метод | Определено | ||
|---|---|---|---|
| SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)
Создает экземпляр SQLError, который может выдаваться самостоятельно или использоваться вместе со свойством error экземпляра SQLErrorEvent. | SQLError | ||
|
Возвращает список вызовов в виде строки для ошибки в момент ее конструирования (только отладочная версия Flash Player). | Error | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
Возвращает строку "Error" по умолчанию или значение, содержащееся в свойстве Error.message, если оно определено. | SQLError | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
| detailArguments | свойство |
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойстваdetailArguments:Array [только для чтения] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.1 |
Массив строковых значений, который используется для создания подробных сообщений об ошибках, предназначенных для конкретного языкового стандарта.
Данное свойство содержит значение или значения, которые подставляются в сообщения об ошибках свойства details для указания конкретного объекта или объектов базы данных (имя таблицы, имя столбца и т. п.), связанных с ошибкой. Предположим, в приложении возникла ошибка с соответствующим сообщением свойства details:
there is already another table or index with this name: 'my_table'
В таком случае свойство экземпляра SQLError detailArguments будет содержать единственный элемент со значением "my_table".
Используя свойство detailID, приложение может идентифицировать конкретное сообщение об ошибке details. Приложение может использовать альтернативный текст для конечного пользователя в соответствии с языковыми настройками этого пользователя. Можно заменить значения соответствующих аргументов массива detailArguments в строке сообщения об ошибке. Эта возможность полезна для приложений, которые отображают сообщения об ошибках свойства details напрямую конечному пользователю, который находится в конкретной языковой среде.
Список значений detailID и соответствующие подробные сообщения об ошибках на английском языке, а также аргументы, см. в приложении "Сообщения с описанием ошибок, идентификаторов и аргументов SQL."
public function get detailArguments():Array| detailID | свойство |
detailID:int [только для чтения] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.1 |
Ссылочный номер, связанный с конкретным сообщением об ошибке. Данное значение используется для поддержки передачи сообщений об ошибках свойства details с учетом конкретных языковых настроек.
Данное свойство присваивает уникальный идентификатор каждому сообщению details. (Для любого типа ошибки со своим идентификатором errorID существует несколько ошибок с уникальными значениями detailID.) Используя такой идентификатор совместно со значением или значениями массива detailArguments, приложение может выдавать подробные сообщения об ошибках с учетом языковых настроек. Эта возможность полезна для приложений, которые отображают сообщения об ошибках свойства details напрямую конечному пользователю, который находится в конкретной языковой среде.
Список значений detailID и соответствующие подробные сообщения об ошибках на английском языке, а также аргументы, см. в приложении "Сообщения с описанием ошибок, идентификаторов и аргументов SQL."
public function get detailID():int| details | свойство |
details:String [только для чтения] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Сведения о текущей ошибке. Предоставляет дополнительную специфическую информацию о возникшей ошибке.
public function get details():String| operation | свойство |
operation:String [только для чтения] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Значение, указывающее операцию, которая была предпринята, когда появилась ошибка. Это значение представляет собой одну из констант, определенную в классе SQLErrorOperation.
public function get operation():StringСм. также
| SQLError | () | Конструктор |
public function SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)| Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Создает экземпляр SQLError, который может выдаваться самостоятельно или использоваться вместе со свойством error экземпляра SQLErrorEvent.
operation:String — Указывает конкретную операцию, вызывавшую сбой. Значение представляет собой одну из констант, определенную в классе SQLErrorOperation.
| |
details:String (default = " | |
message:String (default = " | |
id:int (default = 0) | |
detailID:int (default = -1) | |
detailArgs:Array (default = null) |
См. также
| toString | () | метод |
public function toString():String| Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Возвращает строку "Error" по умолчанию или значение, содержащееся в свойстве Error.message, если оно определено.
String — Сообщение об ошибке.
|