カレントプロシージャ内でのエラー処理の方法を決定します。

構文
On Error [ errNumber ] { GoTo label | Resume Next | GoTo 0 }

構成要素
errNumber

省略可能。Integer 型のエラー番号を示す数式です。この要素を省略すると、ステートメントはカレントプロシージャ内のすべてのエラーを指します。この値では、On Error ステートメントに到達した時点で LotusScript で定義されているすべてのエラー番号を指定できます。

エラー errNumber が発生したときに label で始まるエラー処理ルーチンに制御を移すように指定します。エラーは処理されたとみなされます。

エラー errNumber が発生したときに、エラーの発生したステートメントの次のステートメントから処理を再開するように指定します。エラー処理ルーチンは実行されません。Err、Erl、Error 関数の値はリセットされません。Resume ステートメントでは、これらの値がリセットされます。エラーは処理されたとみなされます。

エラー errNumber が発生したときに、そのエラーがカレントプロシージャ内で処理されないように指定します。errNumber を省略すると、カレントプロシージャ内で処理されるエラーはなくなります。

On Error の処理
On Error ステートメントは、ステートメントが実行されてから、それを含むプロシージャが呼び出し側のプログラムやプロシージャへ制御を戻すまで有効です。

• プロシージャに同じエラー番号に対応する複数の On Error errNumber ステートメントがある場合は、最後に実行されたものがそのエラー番号に対応します。
• エラー番号に対応する On Error errNumber ステートメントがない場合は、最後に実行された On Error ステートメント (errNumber 要素なし) がそのエラー番号に対応します。
• On Error ステートメント (errNumber 要素なし) が何も実行されていなければ、カレントプロシージャはエラーを処理しません。

  この場合、LotusScript はプロシージャの呼び出しプロシージャ内のエラーのための On Error ステートメントを、On Error ステートメントに適用されるのと同じ規則に従って検索します。呼び出し元がエラーを処理しない場合は、呼び出し元の呼び出し元を調べます。このプロセスで適切な On Error ステートメントが見つからなかった場合は、実行を終えて、エラーに対するエラーメッセージを出力ウィンドウに表示します。

エラー処理ルーチンの処理中は、Err、Erl、Error 関数が処理をしているエラー処理ルーチン中のエラーを返します。Resume ステートメントはこれらの値をリセットします。

エラー番号とエラーメッセージの定義
LotusScript では、一般的なエラーとそれに対応するエラー番号 (定数) がファイル lserr.lss に指定されています。これらのエラーと番号を定義するには、スクリプトを実行する前に、コンパイルまたはロードするスクリプトに %Include を使ってこのファイルを取り込みます。これで、On Error ステートメントでこれらのエラー番号を使ってセッション内のエラー処理を制御できるようになります。

Error ステートメントで新しいエラー番号とエラーメッセージを定義できます。

クロスリファレンス
式言語の @Error 関数

式言語の @IfError 関数

式言語の @Failure 関数

例
関連項目

LotusScript ランゲージリファレンス: M - P
Erl 関数
Err 関数
Err ステートメント
Error 関数
Error ステートメント
%Include 命令
Resume ステートメント