ASP.NET CompareValidatorコントロール
定義と用法
CompareValidatorコントロールは、ユーザーが入力コントロールに入力した値を、他の入力コントロールに入力された値や定数値と比較するために使用されます。
注記:入力コントロールが空の場合、検証関数は呼び出されず、検証は成功します。RequiredFieldValidatorコントロールを使用してフィールドを必須フィールドにします。
属性
属性 | 説明 |
---|---|
BackColor | CompareValidatorコントロールの背景色。 |
ControlToCompare | 検証する入力コントロールと比較する入力コントロール。 |
ControlToValidate | 検証する入力コントロールのID。 |
Display |
検証コントロール内のエラーメッセージの表示行動。 合法値は:
|
EnableClientScript | ブール値、クライアント側の検証を有効化するかどうかを規定。 |
Enabled | ブール値、検証コントロールの有効化を規定。 |
ErrorMessage |
検証失敗時にValidationSummaryコントロールに表示されるテキスト。 注記:Text属性が設定されていない場合、このテキストが検証コントロールに表示されます。 |
ForeColor | コントロールの前景色。 |
id | コントロールのユニークなID。 |
IsValid | ControlToValidate で指定された入力コントロールが検証を通過したかどうかを示す布尔値です。 |
Operator |
実行する比較操作のタイプです。 演算子は:
|
runat | コントロールがサーバーコントロールであることを指定します。"server" に設定する必要があります。 |
Text | 検証に失敗したときに表示するメッセージです。 |
Type |
比較する値のデータ型を指定します。 タイプには:
|
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!" を表示します。