ASP.NET CustomValidator 控件


up.gif Validation 服務(wù)器控件

定義和用法

CustomValidator 控件允許您書寫處理輸入值驗證的方法。


屬性

屬性描述
BackColorCustomValidator 控件的背景顏色。
ClientValidationFunction規(guī)定要被執(zhí)行的客戶端腳本函數(shù)的名稱。    注釋:腳本必須用瀏覽器支持的語言編寫,比如 VBScript 或 JScript

使用 VBScript 時,函數(shù)必須位于表單內(nèi):

Sub FunctionName (source, arguments)

使用 JScript 時,函數(shù)必須位于表單內(nèi):

Function FunctionName (source, arguments)

ControlToValidate要驗證的控件的 id。
Display驗證控件的顯示行為。合法值有:
  • None - 控件不顯示。僅用于 ValidationSummary 控件中顯示錯誤消息。
  • Static - 如果驗證失敗,控件顯示錯誤消息。即使輸入通過驗證,也在頁面上預(yù)留顯示消息的空間,即用于顯示消息的空間是預(yù)先分配好的。
  • Dynamic - 如果驗證失敗,控件顯示錯誤消息。如果輸入通過驗證,頁面上不預(yù)留顯示消息的空間,即用于顯示消息的空間是動態(tài)添加的。
EnableClientScript布爾值,規(guī)定是否啟用客戶端驗證。
Enabled布爾值,規(guī)定是否啟用驗證控件。
ErrorMessage當(dāng)驗證失敗時,在 ValidationSummary 控件中顯示的文本。    注釋:如果未設(shè)置 Text 屬性,文本也會顯示在驗證控件中。
ForeColor控件的前景色。
id控件的唯一 id。
IsValid布爾值,指示由 ControlToValidate 指定的控件是否通過驗證。
OnServerValidate規(guī)定被執(zhí)行的服務(wù)器端驗證腳本函數(shù)的名稱。
runat規(guī)定該控件是服務(wù)器控件。必須設(shè)置為 "server"。
Text當(dāng)驗證失敗時顯示的消息。


實例

CustomValidator
在本例中,我們在 .aspx 文件中聲明了兩個 Label 控件,一個 TextBox 控件,一個 Button 控件,和一個 CustomValidator 控件。user() 函數(shù)可檢測輸入值的長度。如果長度小于 8 或大于 16,將在 CustomValidator 控件中顯示文本 "A username must be between 8 and 16 characters!"。


up.gif Validation 服務(wù)器控件