| 套件 | flash.errors |
| 類別 | public class SQLError |
| 繼承 | SQLError  Error Object |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
在非同步執行模式下，當 SQL 資料庫作業發生錯誤時，SQLConnection 或 SQLStatement 實體便會傳送 SQLErrorEvent 物件。SQLError 實體格式的錯誤資訊可以透過 SQLErrorEvent 物件的 error 屬性來存取。
在同步執行模式下，當 SQL 資料庫作業發生錯誤時，SQLConnection 或 SQLStatement 實體便會擲回 SQLError 例外，此例外可以透過將擲回錯誤的程式碼包含在 try..catch 區塊中的方式來處理。
此類別可提供包含錯誤詳細資訊的屬性 (藉由指定所發生的特定錯誤類型)、包含錯誤詳細資訊的文字訊息，以及導致錯誤發生的作業。
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| detailArguments : Array [唯讀]
String 值的陣列，這些值可用來建構地區特定的詳細錯誤訊息。 | 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 |
String 值的陣列，這些值可用來建構地區特定的詳細錯誤訊息。
這個屬性包含用來替代 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, 03:47 PM Z