setError()

システム関数 SysLib.setError は、メッセージを PageHandler または VGUIRecord のフィールドと関連付けたり、あるいは、PageHandler 全体と関連付けます。
  • PageHandler が関数を呼び出す場合、メッセージは、JSP のメッセージまたはメッセージ・タグのロケーションに配置されます。
  • VGWebTransaction のプログラムが関数を呼び出す場合、メッセージは、JSP のフォント・タグのロケーションに配置されます。

関連する Web ページが表示されたときに、メッセージが表示されます。

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

以下の 3 つの構文のうち、最初の構文が、PageHandlers または VGWebTransaction 型のプログラムで使用可能です。2 番目および 3 番目の構文は、PageHandlers でのみ使用可能です。

  SysLib.setError(
    fieldInError anyPageField in,
    msgKey STRING in
    {, fieldInsert sysLibFieldInsert in})
  SysLib.setError(
    this enumerationThis in,
    msgKey STRING in
    {, fieldInsert sysLibFieldInsert in})
  SysLib.setError(msgText STRING in)
fieldInError
SysLib.setError が PageHandler から発行されている場合、fieldInError は、PageHandler 内のフィールドです。

SysLib.setError がプログラムから発行されている場合、fieldInError は、show または converse 文で指定されているレコード内のフィールドです。

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

複数のメッセージをフィールドまたは PageHandler と関連付けることができます。 コントロールが転送されるとメッセージは失われます。具体的には、PageHandler が forward 文を実行する場合、または VGWebTransaction プログラムが transfer 文を実行する場合です。

関連リファレンス
EGL ライブラリー SysLib
forward

フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.