ASP.NET Mobile CustomValidator Control
 Complete ASP.NET Mobile Reference
Definition and Usage
The CustomValidator control allows you to write a method to handle the
validation of the value entered.
Properties
| 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 |
Example 1
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:
<%@ Page
Inherits="System.Web.UI.MobileControls.MobilePage"%>
<%@ Register TagPrefix="Mobile"
Namespace="System.Web.UI.MobileControls"
Assembly="System.Web.Mobile" %>
<script runat="server">
Sub Page2(Sender as Object,E as EventArgs)
If Page.IsValid Then
ActiveForm=f2
txt2.Text="Your username is: " & txt1.text
end if
End Sub
Sub user(source As object,args As ServerValidateEventArgs)
if len(args.Value)<8 or len(args.Value)>16 then
args.IsValid=false
else
args.IsValid=true
end if
End Sub
</script>
<Mobile:Form id="f1" runat="server">
<Mobile:Label runat="server">
Please enter a username
</Mobile:Label>
<Mobile:TextBox id="txt1" runat="server" />
<Mobile:CustomValidator runat="server"
ControlToValidate="txt1"
OnServerValidate="user"
Text="A username must be between 8 and 16 characters!" />
<Mobile:Command OnClick="Page2" runat="server">
Submit</Mobile:Command>
</Mobile:Form>
<Mobile:Form id="f2" runat="server">
<Mobile:Label id="txt2" runat="server" />
</Mobile:Form>
|
Complete ASP.NET Mobile Reference
|
HOME
Printer friendly page
