ASP.NET/Validate控件
外觀
< ASP.NET
共通的屬性
[編輯]屬性 | 描述 |
---|---|
BackColor | 示例 |
ControlToValidate | 要驗證的控件的 id |
Display | 驗證控件的顯示行為。合法值有:None - 控件不显示。仅用于 ValidationSummary 控件中显示错误消息。 |
EnableClientScript | 布爾值,規定是否啟用客戶端驗證。 |
Enabled | 布爾值,規定是否啟用驗證控件。 |
ErrorMessage | 當驗證失敗時,在 ValidationSummary 控件中顯示的文本。 註釋:如果未設置 Text 屬性,文本也會顯示在驗證控件中。 |
ForeColor | 控件的前景顏色 |
id | 控件的唯一 id。 |
IsValid | 布爾值,指示由 ControlToValidate 指定的控件是否通過驗證。 |
runat | 規定該控件是一個伺服器控件。必須設置為 "server"。 |
Text | 當驗證失敗時顯示的消息。 |
示例 | 示例 |
RequiredFieldValidator
[編輯]用於使被驗證控件成為一個必需(必填)的字段。通過該控件,如果輸入值的初始值未改變,則驗證失敗。默認情況下,初始值是空字符串 ("")。InitialValue 屬性不為輸入控件設置默認值,它指示了您不希望用戶在輸入控件中輸入的值。
註釋:輸入值的開頭和結尾的空格將在驗證前被移除。
RegularExpressionValidator
[編輯]ValidationExpression屬性寫入正則表達式。
RangeValidator
[編輯]- MaximumValue
- MinimumValue
- Type: 空間輸入值的類型可以為String、Integer、Date、Double、Currency。
註釋:如果輸入控件為空,驗證不會失敗。請使用 RequiredFieldValidator 控件,使字段必需(必填)。
註釋:如果輸入值無法轉換為指定的數據類型,驗證不會失敗。請使用 CompareValidator 控件,將其 Operator 屬性設置為 ValidationCompareOperator.DataTypeCheck,這樣就可以校驗輸入值的數據類型了。
CompareValidator
[編輯]- Operator 要執行的比較操作的類型。運算符有:Equal、GreaterThan、GreaterThanEqual、LessThan、LessThanEqual、NotEqual、DataTypeCheck
- Type: 空間輸入值的類型可以為String、Integer、Date、Double、Currency。
- ControlToCompare 要與所驗證的控件進行比較的控件名稱。
- ValueToCompare 一個常數值,該值要與由用戶輸入到所驗證的輸入控件中的值進行比較。
註釋:如果輸入控件為空,則不會調用任何驗證函數,並且驗證將成功。使用 RequiredFieldValidator 控件使字段必需(必填)。
CustomValidator
[編輯]- ClientValidationFunction 規定要被執行的客戶端腳本函數的名稱。
- EnableClientScript 布爾值,規定是否啟用客戶端驗證
- OnServerValidate 規定被執行的伺服器端驗證腳本函數的名稱。
- ValidateEmptyText
如果驗證函數在server端運行,需要做一些設定:
- 控件的ValidateEmptyText="True",這樣被驗證控件為空時才可能會被驗證。
- 當所有前端驗證控件通過之後,才會執行server端的定製驗證。
- 在button的處理函數中執行 Page.Validate("ValidationGroupName"); if (!Page.IsValid) return; 其中,ValidationGroupName是一個字符串值,出現在各控件、驗證控件的ValidationGroup="ValidationGroupName" 屬性-值對中。因為在較新版本的.NET中,定製驗證控件的驗證函數必須通過Page.Validate函數才能在伺服器端被執行。
ValidationSummary
[編輯]在該控件中顯示的錯誤消息是由每個驗證控件的 ErrorMessage 屬性規定的。如果未設置驗證控件的 ErrorMessage 屬性,就不會為那個驗證控件顯示錯誤消息。
- DisplayMode 如何顯示摘要。合法值有:BulletList、List、SingleParagraph
- HeaderText ValidationSummary 控件中的標題文本。
- ShowMessageBox 布爾值,規定是否在消息框中顯示驗證摘要。
- ShowSummary 布爾值,規定 ValidationSummary 控件是否顯示或者隱藏。