| 包 | 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 块中来进行处理。
此类提供包含错误详细信息的属性（指定所发生错误的特定类型）、包含错误详细信息的文本消息和导致发生错误的操作。
相关 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)
创建一个可以引发或通过 SQLErrorEvent 实例的 error 属性使用的 SQLError 实例。 | 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 错误详细消息、ID 和参数”。
实现
public function get detailArguments():Array detailID | 属性 |
detailID:int [只读] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.1 |
与特定详细消息关联的引用编号。此值用于支持按地区翻译 details 属性错误消息。
此属性为每个 details 消息提供唯一标识符。（具有特定 errorID 的任何类型错误都有多个具有唯一 detailID 值的错误。）此标识符和 detailArguments 数组中的一个或多个值一起使用，应用程序可以提供特定于地区的详细错误消息。对于要直接向特定地区的最终用户显示此错误的 details 属性错误消息的应用程序，这非常有用。
有关 detailID 值及其相应的英语错误详细消息和参数的列表，请参阅“SQL 错误详细消息、ID 和参数”。
实现
public function get detailID():int details | 属性 |
operation | 属性 |
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) |
相关 API 元素
toString | () | 方法 |
Tue Jun 12 2018, 11:04 AM Z