コントロールのエラー プロパティの設定

ランタイムに無効なフィールドを表示するフォーム アクションを使用して、次のコントロールの有効性とエラー メッセージを設定できます。

  • テキストボックス

  • ドロップダウン リスト

  • カレンダー

  • チェック ボックス

これらのタッチ コントロールおよび非タッチ コントロールでアクションを構成し、プロパティにアクセスすると、ISValid プロパティと ErrorMessage プロパティが使用できます。ErrorMessage が受け入れるのは文字列 (デフォルト: 空) 値で、IsValid が受け入れるのはブール値 (デフォルト: True) です。

  1. フォームを開きます。
  2. テキストボックスやチェック ボックスなどのコントロールをフォームに追加します。
  3. コントロールに、ビジネス ルールなどのアクションを構成します。「フォーム アクション」を参照してください。

    フォーム コントロールでビジネス ルール アクションを呼び出し、ビジネス ルールの出力をフォーム フィールドの IsValid および ErrorMessage プロパティにマップすると、ランタイムにビジネス ルールがフィールド値が有効かどうかを判断します。IsValid が false の場合、フィールドは無効として強調表示され、ポインタをコントロール上に移動すると、ErrorMessage プロパティに設定されているメッセージが表示されます。

    フォーム フィールドを検証するボタンでアクションを呼び出す場合は、検証を引き起こすプロパティを選択することをお勧めします。たとえば、アクションがテキスト ボックスの IsValid/ErrorMessage プロパティを設定するときに、検証を引き起こすがボタンに選択されている場合、フォームに有効なフィールドがない場合にのみこのアクションが実行可能になります。ただし、フォームに無効なフィールドがある場合は、アクションが関連付けられているボタンの検証を引き起こすプロパティをクリアします。

    コントロールのアクションの構成中に定義された ErrorMessage は、コントロールのプロパティの構成中に定義された ErrorMessage よりも優先されます。