@Failure (式言語)

構文

@Failure( string )

パラメータ

string

文字列。ユーザーに表示するエラーメッセージです。

戻り値

string

文字列。エラーメッセージです。

使用法

@Failure は入力確認式のみで使用します。

@Failure によって式の実行が終了されることはありません。式を強制的に終了する場合は、@Return を使用します。

入力確認式で @Success (値 1) が返された場合、フィールドは有効です。その他の戻り値は有効条件に一致しないことを意味します。文字列の戻り値はエラーメッセージとして表示されます。入力確認式での @Failure の使用は必須ではありませんが、明確さを確保するために使用することをお勧めします。

例

次の例は、入力確認式です。ユーザーが [AreaCode] というフィールドに 999 より大きい数値を入力すると「Area codes have only 3 digits」というエラーメッセージが返されます。

@If(AreaCode<1000;@Success;@Failure("Area codes have only 3 digits"))

クロスリファレンス

LotusScript® 言語の On Error ステートメント

LotusScript ODBC Connection クラス、Query クラス、ResultSet クラスの GetErrorMessage メソッド (『Notes Domino Application development wiki』(http://www-10.lotus.com/ldd/ddwiki.nsf) のトピックを参照)。

Java™ NotesError クラスと NotesException クラス