ASP.NET CompareValidatorコントロール

定義と用法

CompareValidatorコントロールは、ユーザーが入力コントロールに入力した値を、他の入力コントロールに入力された値や定数値と比較するために使用されます。

注記:入力コントロールが空の場合、検証関数は呼び出されず、検証は成功します。RequiredFieldValidatorコントロールを使用してフィールドを必須フィールドにします。

属性

属性 説明
BackColor CompareValidatorコントロールの背景色。
ControlToCompare 検証する入力コントロールと比較する入力コントロール。
ControlToValidate 検証する入力コントロールのID。
Display

検証コントロール内のエラーメッセージの表示行動。

合法値は:

  • None 検証メッセージは内联で表示されません。
  • Static ページレイアウトに検証メッセージを表示するためのスペースを割り当てます。
  • Dynamic 検証が失敗した場合、検証メッセージを表示するためのスペースをページに動的に追加します。
EnableClientScript ブール値、クライアント側の検証を有効化するかどうかを規定。
Enabled ブール値、検証コントロールの有効化を規定。
ErrorMessage

検証失敗時にValidationSummaryコントロールに表示されるテキスト。

注記:Text属性が設定されていない場合、このテキストが検証コントロールに表示されます。

ForeColor コントロールの前景色。
id コントロールのユニークなID。
IsValid ControlToValidate で指定された入力コントロールが検証を通過したかどうかを示す布尔値です。
Operator

実行する比較操作のタイプです。

演算子は:

  • Equal
  • GreaterThan
  • GreaterThanEqual
  • LessThan
  • LessThanEqual
  • NotEqual
  • DataTypeCheck
runat コントロールがサーバーコントロールであることを指定します。"server" に設定する必要があります。
Text 検証に失敗したときに表示するメッセージです。
Type

比較する値のデータ型を指定します。

タイプには:

  • Currency
  • Date
  • Double
  • Integer
  • String
ValueToCompare ユーザーが検証する入力コントロールに入力された値と比較する通常の値です。

インスタンス

CompareValidator
この例では、.aspx ファイルで 2つの TextBox コントロール、1つの Button コントロール、および 1つの CompareValidator コントロールを宣言しました。検証に失敗すると、CompareValidator コントロールで黄色い背景と赤いテキストで "Validation Failed!" を表示します。
CompareValidator 2
この例では、.aspx ファイルで 2つの TextBox、1つの ListBox コントロール、1つの Button コントロール、および 1つの CompareValidator コントロールを宣言しました。check_operator() 関数は、ListBox コントロールで選択された演算子を CompareValidator コントロールの演算子に設定し、CompareValidator コントロールを検証します。検証に失敗すると、CompareValidator コントロールで黄色い背景と赤いテキストで "Validation Failed!" を表示します。