| Пакет | 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.
Этот класс передает свойства, содержащие сведения об ошибках (указывая конкретный тип возникшей ошибки), текстовое сообщение со сведениями об ошибке и операцию, вызывавшую ее появление.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | 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 | ||
| Метод | Определено | ||
|---|---|---|---|
SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)
Создает экземпляр SQLError, который может выдаваться самостоятельно или использоваться вместе со свойством error экземпляра SQLErrorEvent. | SQLError | ||
|
Возвращает список вызовов для данной ошибки в момент ее конструирования в форме строки. | Error | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса 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 | свойство |
operation | свойство |
operation:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Значение, указывающее операцию, которая была предпринята, когда появилась ошибка. Это значение представляет собой одну из констант, определенную в классе SQLErrorOperation.
Реализация
public function get operation():StringСвязанные элементы API
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) |
Связанные элементы API
toString | () | метод |
Tue Jun 12 2018, 11:34 AM Z