（AIR のみ）
パッケージflash.errors
クラスpublic class SQLError
継承SQLError Inheritance Error Inheritance Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0

SQLError インスタンスは、失敗した操作に関する詳細情報を提供します。

非同期実行モードでは、SQL データベース操作でエラーが発生すると、SQLConnection インスタンスまたは SQLStatement インスタンスによって SQLErrorEvent オブジェクトが送出されます。SQLError インスタンスの形式でのエラー情報には、SQLErrorEvent オブジェクトの error プロパティからアクセスできます。

同期実行モードでは、SQL データベース操作でエラーが発生すると、SQLConnection インスタンスまたは SQLStatement インスタンスによって SQLError 例外がスローされます。この例外を処理するには、エラーをスローするコードを try..catch ブロックに入れます。

このクラスは、エラーの詳細 (発生したエラーの特定のタイプを指定)、エラーの詳細を示すテキストメッセージ、およびエラーの原因となった操作を含むプロパティを示します。

関連項目

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

パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  AIR-only detailArguments : Array
[読み取り専用] ロケール固有の詳細なエラーメッセージを作成するために使用できる String 値の配列です。
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)
スロー可能、または SQLErrorEvent インスタンスの error プロパティで使用可能な SQLError インスタンスを作成します。
SQLError
 Inherited
getStackTrace():String
エラーの構築時にエラーの呼び出しスタックをストリングで返します (デバッグ版の Flash Player および AIR Debug Launcher (ADL) のみ)。デバッグ版の Flash Player または ADL を使用していない場合は、null を返します。
Error
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
AIR-only toString():String
デフォルトでは "Error" というストリングを返します。Error.message プロパティが定義されている場合は、その値を返します。
SQLError
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
プロパティの詳細
AIR-only 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 error detail messages, ids, and arguments
」を参照してください。



実装
    public function get detailArguments():Array
AIR-only detailIDプロパティ 
detailID:int  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.1

特定の詳細なメッセージに関連付けられた参照番号です。この値は、details プロパティのエラーメッセージに対するロケール固有の変換をサポートするために使用します。

このプロパティは、各 details メッセージについて一意の識別子を提供します。(特定の errorID を持つすべてのタイプのエラーで、一意の detailID 値を持つ複数のエラーが存在します)。detailArguments 配列の値 (複数可) とこの識別子を組み合わせて使用することにより、アプリケーションでロケール固有の詳細なエラーメッセージを提供できます。これは、特定のロケールのエンドユーザーに、このエラーに対応する details プロパティのエラーメッセージを直接表示するアプリケーションで役立ちます。

detailID の値と、それに対応する英語のエラー詳細メッセージおよび引数のリストについては、付録「SQL error detail messages, ids, and arguments
」を参照してください。



実装
    public function get detailID():int
AIR-only detailsプロパティ 
details:String  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0

現在のエラーの詳細です。発生したエラーに関する追加の固有情報を示します。



実装
    public function get details():String
AIR-only operationプロパティ 
operation:String  [読み取り専用]

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0

エラーの発生時に試行されていた操作を示す値です。この値は、SQLErrorOperation クラスで定義されている定数の 1 つです。



実装
    public function get operation():String

関連項目

flash.errors.SQLErrorOperation
コンストラクタの詳細
AIR-only 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 クラスで定義されている定数の 1 つです。
 
details:String (default = "") — 現在のエラーの詳細です。
 
message:String (default = "") — 発生したエラーの説明です。
 
id:int (default = 0) — 特定のエラーメッセージに関連付けられた参照番号です。
 
detailID:int (default = -1) — 詳細なエラーメッセージに関連付けられた参照番号です。
 
detailArgs:Array (default = null) — ロケール固有の詳細なエラーメッセージを作成するために使用できる置き換え値の順序配列です。

関連項目

flash.errors.SQLErrorOperation
メソッドの詳細
AIR-only toString()メソッド
public function toString():String

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0

デフォルトでは "Error" というストリングを返します。Error.message プロパティが定義されている場合は、その値を返します。

戻り値
String — エラーメッセージです。



© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/flash/errors/SQLError.html