| パッケージ | トップレベル |
| クラス | public dynamic class Error |
| 継承 | Error Object |
| サブクラス | ArgumentError, DefinitionError, EvalError, IllegalOperationError, InvalidSWFError, IOError, MemoryError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, StackOverflowError, SyntaxError, TypeError, URIError, VerifyError, VideoError |
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Error コンストラクタ関数を使用します。一般には、try コードブロック内から新しい Error オブジェクトをスローします。そして、catch コードブロックまたは finally コードブロックでこれをキャッチします。
Error クラスのサブクラスを作成し、そのクラスのインスタンスをスローすることもできます。
関連項目
| プロパティ | 定義元 | ||
|---|---|---|---|
![]() | constructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
| Object | |
| errorID : int
[read-only]
特定のエラーメッセージに関連付けられた参照番号です。
| Error | ||
| message : String
Error オブジェクトに関連付けられたメッセージです。
| Error | ||
| name : String
Error オブジェクトの名前です。
| Error | ||
![]() | prototype : Object
[static]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
| Object | |
| メソッド | 定義元 | ||
|---|---|---|---|
|
新しい Error オブジェクトを作成します。
| Error | ||
|
エラーの構築時にエラーの呼び出しスタックをストリングで返します (デバッガバージョンの Flash Player のみ)。
| Error | ||
![]() |
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
| Object | |
![]() |
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
| Object | |
![]() |
指定されたプロパティが存在し列挙できるかどうかを示します。
| Object | |
![]() |
ループ処理に対するダイナミックプロパティの可用性を設定します。
| Object | |
|
デフォルトでは "Error" というストリングを返します。Error.message プロパティが定義されている場合は、その値を返します。
| Error | ||
![]() |
指定されたオブジェクトのプリミティブな値を返します。
| Object | |
| errorID | プロパティ |
errorID:int [read-only]
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
特定のエラーメッセージに関連付けられた参照番号です。カスタム Error オブジェクトの場合、この番号はコンストラクタで提供される id パラメータの値です。
public function get errorID():int
| message | プロパティ |
public var message:String
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Error オブジェクトに関連付けられたメッセージです。デフォルトでは、このプロパティの値は "Error" です。Error オブジェクトを作成する際に、message プロパティを指定するには、Error コンストラクタ関数にエラーストリングを渡します。
関連項目
| name | プロパティ |
public var name:String
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
Error オブジェクトの名前です。デフォルトでは、このプロパティの値は "Error" です。
関連項目
| Error | () | コンストラクタ |
public function Error(message:String = "", id:int = 0)
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
新しい Error オブジェクトを作成します。message を指定した場合は、その値がオブジェクトの Error.message プロパティに割り当てられます。
message:String (default = "") — Error オブジェクトに関連付けられたストリング。このパラメータはオプションです。
|
|
id:int (default = 0) — 特定のエラーメッセージに関連付ける参照番号です。
|
関連項目
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| getStackTrace | () | メソッド |
public function getStackTrace():String
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
エラーの構築時にエラーの呼び出しスタックをストリングで返します (デバッガバージョンの Flash Player のみ)。次の例に示されているように、戻り値の先頭行は、例外オブジェクトのストリング表現で、その後にはスタックトレースエレメントが続きます。
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)
String — 呼び出しスタックのストリング表現です。
|
| toString | () | メソッド |
public override function toString():String
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9 |
デフォルトでは "Error" というストリングを返します。Error.message プロパティが定義されている場合は、その値を返します。
String — エラーメッセージです。
|
関連項目
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 MessageErrorExample クラスを使用して、カスタムエラーを作成する方法を示しています。これを行うには、以下の手順を実行します。
nullArray を宣言しますが、新しい Array オブジェクトは作成されません。push() メソッドを使用して、初期化されていない配列に値をロードしようとします。このエラー処理セグメントは、CustomError クラス (Error の拡張) を使用してカスタムエラーをキャッチします。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);
}
}
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート
現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/Error.html