ASP.NET CustomValidator控件


Validation 服务器控件

定義と用法

CustomValidator コントロールを使用すると、入力値の検証を処理するメソッドを記述できます。


属性

属性 描述
BackColor CustomValidator コントロールの背景色。
ClientValidationFunction 実行されるクライアント側スクリプト関数の名前を指定します。注释:スクリプトは、ブラウザでサポートされている言語 (VBScript や JScript など) で記述する必要があります。

VBScript を使用する場合、関数はフォーム内に置く必要があります:

Sub FunctionName (source, arguments)

JScript を使用する場合、関数はフォーム内に置く必要があります:

Function FunctionName (source, arguments)

ControlToValidate 検証するコントロールのID。
Display 検証コントロールの表示動作。有効な値は次のとおりです。
  • None - コントロールは表示されません。ValidationSummary コントロールでエラーメッセージを表示する場合にのみ使用されます。
  • Static - 検証が失敗した場合、コントロールはエラーメッセージを表示します。入力が検証を通過した場合でも、メッセージを表示するスペースがページ上に確保されます。つまり、メッセージ表示用のスペースは事前に割り当てられています。
  • Dynamic - 検証が失敗した場合、コントロールはエラーメッセージを表示します。入力が検証を通過した場合、ページ上にメッセージ表示用のスペースは確保されません。つまり、メッセージ表示用のスペースは動的に追加されます。
EnableClientScript クライアント側の検証を有効にするかどうかを指定するブール値です。
Enabled 検証コントロールを有効にするかどうかを指定するブール値です。
ErrorMessage 検証が失敗したときに ValidationSummary コントロールに表示されるテキストです。注释:Text プロパティが設定されていない場合、テキストは検証コントロールにも表示されます。
ForeColor コントロールの前景色。
id コントロールの一意のID。
IsValid ControlToValidate で指定されたコントロールが検証を通過したかどうかを示すブール値です。
OnServerValidate 実行されるサーバー側検証スクリプト関数の名前を指定します。
runat このコントロールがサーバー コントロールであることを指定します。 "server" に設定する必要があります。
Text 検証失敗時に表示されるメッセージ。


实例

CustomValidator
この例では、.aspx ファイル内で 2 つの Label コントロール、1 つの TextBox コントロール、1 つの Button コントロール、および 1 つの CustomValidator コントロールを宣言します。user() 関数は入力値の長さを検出できます。長さが 8 未満または 16 より大きい場合、CustomValidator コントロールにテキスト "A username must be between 8 and 16 characters!" が表示されます。


Validation 服务器控件 其他扩展