| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Error クラスには、スクリプトで発生したエラーに関する情報が含まれています。ActionScript 3.0 アプリケーションの開発では、コンパイルしたコードを Flash Player のデバッグ版で実行すると、Error 型またはサブクラスの例外がダイアログボックスに表示されるので、コードのトラブルシューティングに役立ちます。Error オブジェクトを作成するには、
Error コンストラクタ関数を使用します。一般には、
try コードブロック内から新しい Error オブジェクトをスローします。そして、
catch コードブロックまたは
finally コードブロックでこれをキャッチします。
Error クラスのサブクラスを作成し、そのサブクラスのインスタンスをスローすることもできます。
例を表示
errorID:int [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
特定のエラーメッセージに関連付けられた参照番号です。カスタム Error オブジェクトの場合、この番号はコンストラクタで提供される id パラメータの値です。
実装 public function get errorID():intpublic var message:String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Error オブジェクトに関連付けられたメッセージです。デフォルトでは、このプロパティの値は "Error" です。 Error オブジェクトを作成する際に、message プロパティを指定するには、Error コンストラクタ関数にエラーストリングを渡します。
関連項目
public var name:String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Error オブジェクトの名前です。デフォルトでは、このプロパティの値は "Error" です。
関連項目
public function Error(message:String = "", id:int = 0)| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
新しい Error オブジェクトを作成します。message を指定した場合は、その値がオブジェクトの Error.message プロパティに割り当てられます。
パラメータ | message:String (default = "") — Error オブジェクトに関連付けられたストリング。このパラメータはオプションです。 |
| |
| id:int (default = 0) — 特定のエラーメッセージに関連付ける参照番号です。 |
関連項目
例
次の例では、新しい Error オブジェクト
err を作成し、次に
Error() コンストラクタを使用して、ストリング
"New Error Message" を
err に割り当てます。
var err:Error = new Error();
trace(err.toString()); // Error
err = new Error("New Error Message");
trace(err.toString()); // Error: New Error Message
public function getStackTrace():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
エラーの構築時にエラーの呼び出しスタックをストリングで返します (デバッグ版の Flash Player および AIR Debug Launcher (ADL) のみ)。デバッグ版の Flash Player または ADL を使用していない場合は、null を返します。次の例に示されているように、戻り値の先頭行は、例外オブジェクトのストリング表現で、その後にはスタックトレースエレメントが続きます。
TypeError: null cannot be converted to an object
at com.xyz.OrderEntry.retrieveData(OrderEntry.as:995)
at com.xyz.OrderEntry.init(OrderEntry.as:200)
at com.xyz.OrderEntry.$construct(OrderEntry.as:148)
戻り値override public function toString():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
デフォルトでは "Error" というストリングを返します。Error.message プロパティが定義されている場合は、その値を返します。
戻り値関連項目
例
次の例では、新しい Error オブジェクト
err を作成し、次に
Error() コンストラクタを使用して、ストリング
"New Error Message" を
err に割り当てます。 最後に、
message プロパティには
"Another New Error Message" が設定され、
"New Error Message" は上書きされます。
var err:Error = new Error();
trace(err.toString()); // Error
err = new Error("New Error Message");
trace(err.toString()); // Error: New Error Message
err.message = "Another New Error Message";
trace(err.toString()); // Error: Another New Error Message
次の例は、
ErrorExample クラスを使用して、カスタムエラーを作成する方法を示しています。これを行うには、以下の手順を実行します。
-
Array 型のローカル変数
nullArray を宣言しますが、新しい Array オブジェクトは作成されません。
-
コンストラクタはエラー処理コードセグメント内で
push() メソッドを使用して、初期化されていない配列に値をロードしようとします。このエラー処理セグメントは、CustomError クラス(Error の拡張)を使用してカスタムエラーをキャッチします。
-
CustomError がスローされると、コンストラクタはこれをキャッチし、
trace() ステートメントを使用してエラーメッセージを出力します。
package
{
import flash.display.Sprite;
public class ErrorExample extends Sprite
{
private var nullArray:Array;
public function ErrorExample()
{
try
{
nullArray.push("item");
}
catch(e:Error)
{
throw new CustomError("nullArray is null");
}
}
}
}
class CustomError extends Error
{
public function CustomError(message:String)
{
super(message);
}
}
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 12:14 AM -08:00