ASP.NET CustomValidator 控件

Validation Server Controls 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 檔中聲明了兩個 Label 控件，一個 TextBox 控件，一個 Button 控件，和一個 CustomValidator 控件。user() 函數可檢測輸入值的長度。如果長度小於 8 或大於 16，將在 CustomValidator 控件中顯示文本 "A username must be between 8 and 16 characters!"。

Validation Server Controls Validation 伺服器控件