| 包 | flash.errors |
| 类 | public class SQLError |
| 继承 | SQLError  Error Object |
| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
在异步执行模式下，当 SQL 数据库操作发生错误时，SQLConnection 或 SQLStatement 实例将调度 SQLErrorEvent 对象。有关该错误的信息可以从 SQLErrorEvent 对象的 error 属性以 SQLError 实例的形式进行访问。
在同步执行模式中，当 SQL 数据库操作发生错误时，SQLConnection 或 SQLStatement 实例会引发 SQLError 异常，该异常可通过将引发错误的代码放在 try..catch 块中来进行处理。
此类提供包含错误详细信息的属性（指定所发生错误的特定类型）、包含错误详细信息的文本消息和导致发生错误的操作。
另请参见
| 属性 | 定义方 | ||
|---|---|---|---|
 | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
 detailArguments : Array[只读 (read-only)] 一组字符串值数组，可用于按地区构造详细错误消息。 | SQLError | ||
| detailID : int [只读 (read-only)] 与特定详细消息关联的引用编号。 | SQLError | ||
| details : String [只读 (read-only)] 当前错误的详细信息。 | SQLError | ||
| errorID : int [只读 (read-only)]
包含与特定错误消息相关联的引用编号。 | Error | |
| message : String
包含与 Error 对象关联的消息。 | Error | |
| name : String
包含 Error 对象的名称。 | Error | |
| operation : String [只读 (read-only)] 指示在发生错误时尝试执行的操作的值。 | SQLError | ||
| prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | |
| 方法 | 定义方 | ||
|---|---|---|---|
| SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null) 创建一个可以引发或通过 SQLErrorEvent 实例的 error 属性使用的 SQLError 实例。 | SQLError | ||
|
在构造错误时，以字符串形式返回错误的调用堆栈（仅适用于 Flash Player 的调试版和 AIR Debug Launcher (ADL)）；如果未使用 Flash Player 的调试版或 ADL，则返回 null。 | Error | |
|
指示对象是否已经定义了指定的属性。 | Object | |
|
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
指示指定的属性是否存在、是否可枚举。 | Object | |
|
设置循环操作动态属性的可用性。 | Object | |
默认情况下，返回字符串“Error”；如果已定义，则返回 Error.message 属性中包含的值。 | SQLError | ||
|
返回指定对象的原始值。 | Object | |
| detailArguments | 属性 |
隐藏继承的公共属性
显示继承的公共属性detailArguments:Array [只读 (read-only)] | 语言版本: | 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 错误详细消息、id 和参数。”
public function get detailArguments():Array| detailID | 属性 |
detailID:int [只读 (read-only)] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.1 |
与特定详细消息关联的引用编号。此值用于支持按地区翻译 details 属性错误消息。
此属性为每个 details 消息提供唯一标识符。（具有特定 errorID 的任何类型错误都有多个具有唯一 detailID 值的错误。）此标识符和 detailArguments 数组中的一个或多个值一起使用，应用程序可以提供特定于地区的详细错误消息。对于要直接向特定地区的最终用户显示此错误的 details 属性错误消息的应用程序，这非常有用。
有关 detailID 值及其相应的英语错误详细消息和参数的列表，请参阅附录“SQL 错误详细消息、id 和参数。”
public function get detailID():int| details | 属性 |
details:String [只读 (read-only)] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0 |
当前错误的详细信息。提供有关所发生错误的更多特定信息。
public function get details():String| operation | 属性 |
operation:String [只读 (read-only)] | 语言版本: | 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 |
创建一个可以引发或通过 SQLErrorEvent 实例的 error 属性使用的 SQLError 实例。
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 — 错误消息。 |