Главная / Action Script 3
(Только AIR)
Пакетflash.errors
Классpublic class SQLError
НаследованиеSQLError Inheritance Error Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Экземпляр SQLError предоставляет подробную информацию о невыполненной операции.

Когда эта ошибка возникает при выполнении операции базы данных SQL в асинхронном режиме, экземпляр SQLConnection или SQLStatement отправляет объект SQLErrorEvent. Информацию об ошибке в виде экземпляра SQLError можно получить через свойство error объекта SQLErrorEvent.

Когда ошибка возникает при выполнении операции базы данных SQL в синхронном режиме, объект SQLConnection или SQLStatement выдает исключение SQLError, которое можно обработать путем включения кода, вызывающего ошибку в блок try..catch.

Этот класс передает свойства, содержащие сведения об ошибках (указывая конкретный тип возникшей ошибки), текстовое сообщение со сведениями об ошибке и операцию, вызывавшую ее появление.

См. также

flash.events.SQLErrorEvent
flash.data.SQLConnection
flash.data.SQLStatement


Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  AIR-only detailArguments : Array
[только для чтения] Массив строковых значений, который используется для создания подробных сообщений об ошибках, предназначенных для конкретного языкового стандарта.
SQLError
  AIR-only detailID : int
[только для чтения] Ссылочный номер, связанный с конкретным сообщением об ошибке.
SQLError
  AIR-only details : String
[только для чтения] Сведения о текущей ошибке.
SQLError
 InheritederrorID : int
[только для чтения] Содержит номер ссылки, связанный с конкретным сообщением об ошибке.
Error
 Inheritedmessage : String
Содержит сообщение, связанное с объектом Error.
Error
 Inheritedname : String
Содержит имя объекта Error.
Error
  AIR-only operation : String
[только для чтения] Значение, указывающее операцию, которая была предпринята, когда появилась ошибка.
SQLError
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
Общедоступные методы
 МетодОпределено
  
AIR-only SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)
Создает экземпляр SQLError, который может выдаваться самостоятельно или использоваться вместе со свойством error экземпляра SQLErrorEvent.
SQLError
 Inherited
Возвращает список вызовов в виде строки для ошибки в момент ее конструирования (только отладочная версия Flash Player).
Error
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
Возвращает строку "Error" по умолчанию или значение, содержащееся в свойстве Error.message, если оно определено.
SQLError
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве
AIR-only detailArgumentsсвойство
detailArguments:Array  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  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
AIR-only detailIDсвойство 
detailID:int  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.1

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

Данное свойство присваивает уникальный идентификатор каждому сообщению details. (Для любого типа ошибки со своим идентификатором errorID существует несколько ошибок с уникальными значениями detailID.) Используя такой идентификатор совместно со значением или значениями массива detailArguments, приложение может выдавать подробные сообщения об ошибках с учетом языковых настроек. Эта возможность полезна для приложений, которые отображают сообщения об ошибках свойства details напрямую конечному пользователю, который находится в конкретной языковой среде.

Список значений detailID и соответствующие подробные сообщения об ошибках на английском языке, а также аргументы, см. в приложении "Сообщения с описанием ошибок, идентификаторов и аргументов SQL."



Реализация
    public function get detailID():int
AIR-only detailsсвойство 
details:String  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Сведения о текущей ошибке. Предоставляет дополнительную специфическую информацию о возникшей ошибке.



Реализация
    public function get details():String
AIR-only operationсвойство 
operation:String  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Значение, указывающее операцию, которая была предпринята, когда появилась ошибка. Это значение представляет собой одну из констант, определенную в классе SQLErrorOperation.



Реализация
    public function get operation():String

См. также

Сведения о конструкторе
AIR-only SQLError()Конструктор
public function SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)

Язык версии : ActionScript 3.0
Версии среды выполнения:  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) — Упорядоченный массив подстановочных значений, который используется для создания подробных сообщений об ошибках, предназначенных для конкретного языкового стандарта.

См. также

Сведения о методе
AIR-only toString()метод
public function toString():String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

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

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