ASP.NET CustomValidator 控件

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

定義和用法

CustomValidator 控件允許您書寫處理輸入值驗(yàn)證的方法。

屬性

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

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

Sub FunctionName (source, arguments)

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

Function FunctionName (source, arguments)

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

實(shí)例

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

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