setError()

システム関数 SysLib.setError は、メッセージを PageHandler または UI レコード の項目と関連付けたり、あるいは PageHandler または UI レコード 全体と関連付けます。メッセージは、JSP の JSF メッセージまたはメッセージ・タグのロケーションに配置され、関連する Web ページが表示されると表示されます。

検証機能が SysLib.setError を呼び出す場合、この機能の終了時に Web ページが自動的に再表示されます。

  SysLib.setError(
    itemInError anyPageItem in,
    msgKey STRING in
    {, itemInsert sysLibItemInsert in})
  SysLib.setError(
    this enumerationThis in,
    msgKey STRING in
    {, itemInsert sysLibItemInsert in})
  SysLib.setError(msgText STRING in)
itemInError
誤りのある PageHandler 項目の名前です。

SysLib.setError がプログラムから発行されている場合、itemInError は、forward または converse 文で指定されている UI レコード内の項目です。

UIRecordName
forward または converse 文で指定されている UI レコードの名前。 この場合、メッセージは項目固有ではなく、そのレコードに関連付けられています。
this
SysLib.setError の発行元の PageHandler を参照します。この場合、メッセージは項目固有ではなく、PageHandler に全体として関連付けされます。 this の詳細については、『変数および定数の参照』を参照してください。
msgKey
実行時に使用されるメッセージ・リソース・バンドルまたはプロパティー・ファイルにキーを提供する文字項目またはリテラル (型 CHAR または MBCHAR) です。キーがブランクの場合、メッセージはメッセージ挿入の連結となります。
itemInsert
出力メッセージへの挿入として含まれる文字項目またはリテラルです。メッセージ・テキスト内の置換シンボルは、次の例のような中括弧で囲まれた整数です。
  Invalid file name {0}
msgText
ほかの引数を指定しない場合に指定可能な文字項目またはリテラルです。テキストは、ページ全体に関連付けられます。

複数のメッセージを 1 つの項目または UI レコードまたは PageHandler と関連付けすることができます。EGL ランタイムは、ページが再表示されるときにメッセージを表示します。コントロールが転送される (特に、PageHandler が forward 文を実行する場合)と、それらのメッセージは失われます。

関連する参照項目
EGL ライブラリー SysLib
forward

ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005.