The CustomValidator control allows you to write a method to handle the
validation of the value entered.
| Property |
Value |
Description |
| Alignment |
left
center
right |
Optional. How to align the control |
| BackColor |
rgb(x,x,x)
#xxxxxx
colorname |
Optional. A background color for the control |
| ControlToValidate |
id_of_target_control |
Optional. The id of the control to validate |
| Display |
None
Static
Dynamic |
Optional. The display behavior for the validation control.
Legal values are:
- None (the control is not displayed. Used to show the error message
only in the ValidationSummary control)
- Static (the control displays an error message if validation fails.
Space is reserved on the page for the message even if the input passes
validation
- Dynamic (the control displays an error message if validation fails.
Space is not reserved on the page for the message if the input passes
validation
Dynamic is default |
| ErrorMessage |
errortext_for_summary |
Optional. The text to display in the ValidationSummary
control when validation fails |
| ForeColor |
rgb(x,x,x)
#xxxxxx
colorname |
Optional. A foreground color for the control |
| Font-Bold |
false
true |
Optional. Specifies whether or not the text in the control should be bold |
| Font-Italic |
false
true |
Optional. Specifies whether or not the text in the control should be italic |
| Font-Name |
fontname |
Optional. Specifies the font name of the text in the
control |
| Font-Size |
normal
small
large |
Optional. Specifies the font size of the text in the
control |
| id |
unique_name |
Optional. A unique id for the control |
| OnServerValidate |
function_name |
Optional. Specifies the name of the server-side validation script
function to be executed |
| runat |
"server" |
Required. Specifies that the control is a server control |
| StyleReference |
name_of_style_element |
Optional. Specifies a reference to a style to be applied to
the control |
| Text |
errortext |
Optional. The message to display when validation fails |
| Wrapping |
wrap
nowrap |
Optional. Specifies whether or not the text in the control should wrap |
The following example contains two forms in an .aspx file. The first form has
a label with the text "Please enter a username", an input box to input
a username, a CustomValidator control that checks that the input value is
between 8 and 16 characters, and a submit button. The second page is activated by the
submit button on the first page, and displays a response. If the input value
validates as an error, an error message is displayed: