RangeValidator Control

Definition and Usage

The RangeValidator control is used to check that the user enters an input value that falls between two values. It is possible to check ranges within numbers, dates, and characters.

Note: The validation will not fail if the input control is empty. Use the RequiredFieldValidator control to make the field required.

Note: The validation will not fail if the input value cannot be converted to the data type specified. Use the CompareValidator control, with its Operator property set to ValidationCompareOperator.DataTypeCheck, to verify the data type of the input value.

Properties

Property	Description
BackColor	The background color of the RangeValidator control
ControlToValidate	The id of the control to validate
Display	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
EnableClientScript	A Boolean value that specifies whether client-side validation is enabled or not
Enabled	A Boolean value that specifies whether the validation control is enabled or not
ErrorMessage	The text to display in the ValidationSummary control when validation fails. Note: This text will also be displayed in the validation control if the Text property is not set
ForeColor	The foreground color of the control
id	A unique id for the control
IsValid	A Boolean value that indicates whether the control specified by ControlToValidate is determined to be valid
MaximumValue	Specifies the maximum value of the input control
MinimumValue	Specifies the minimum value of the input control
runat	Specifies that the control is a server control. Must be set to "server"
Type	Specifies the data type of the value to check. The types are: Currency Date Double Integer String
Text	The message to display when validation fails

Example 1

In the following example we declare one TextBox control, one RangeValidator control, one Label control, and one Button control in an .aspx file. The submit() function checks if the page is valid. If it is valid, it returns "The page is valid!" in the Label control. If it is not valid, it returns "The page is not valid!" in the Label control. If validation fails, the text "The date must be between 1/1/2002 and 31/5/2002!" will be displayed in the RangeValidator control:

<script runat="server">
  sub submit(sender As Object, e As EventArgs)
    if Page.IsValid then
      lbl1.Text="The page is valid!"
    else
      lbl1.Text="the page is not valid!"
    end if
  end sub
</script>

<html>
<body>
<form runat="server">
Enter a date between 1/1/2002 and 31/5/2002:
<br />
<asp:TextBox id="tbox1" runat="server"/>
<br />
<asp:RangeValidator id="rv1"
     ControlToValidate="tbox1"
     MinimumValue="1/1/2002"
     MaximumValue="31/5/2002"
     Type="Date"
     EnableClientScript="false"
     Text="The date must be between 1/1/2002 and 31/5/2002!"
     runat="server"/>
<br /><br />
<asp:Label id="lbl1" runat="server"/>
<br /><br />
<asp:Button id="b1" Text="Submit"
OnClick="submit" runat="server"/>
</form>
</body>
</html>

Example 2

In the following example we declare one TextBox control, one RangeValidator control, one Label control, and one Button control in an .aspx file. The submit() function checks if the page is valid. If it is valid, it returns "The page is valid!" in the Label control. If it is not valid, it returns "The page is not valid!" in the Label control. If validation fails, the text "The value must be from 1 to 100!" will be displayed in the RangeValidator control:

<script runat="server">
  sub submit(sender As Object, e As EventArgs)
    if Page.IsValid then
      lbl1.Text="The page is valid!"
    else
      lbl1.Text="the page is not valid!"
    end if
  end sub
</script>

<html>
<body>
<form runat="server">
Enter a number from 1 to 100:
<br />
<asp:TextBox id="tbox1" runat="server"/>
<br />
<asp:RangeValidator id="rv1"
     ControlToValidate="tbox1"
     MinimumValue="1"
     MaximumValue="100"
     Type="Integer"
     EnableClientScript="false"
     Text="The value must be from 1 to 100!"
     runat="server"/>
<br /><br />
<asp:Label id="lbl1" runat="server"/>
<br /><br />
<asp:Button id="b1" Text="Submit"
OnClick="submit" runat="server"/>
</form>
</body>
</html>

Jump to: Top of Page or HOME or Printer friendly page

Search W3Schools:

What Others Say About Us

Does the world know about us? Check out these places:

Dogpile Alta Vista MSN Google Excite Lycos Yahoo Ask Jeeves

We Help You For Free. You Can Help Us!

W3Schools is for training only. We do not warrant its correctness or its fitness for use. The risk of using it remains entirely with the user. While using this site, you agree to have read and accepted our terms of use and privacy policy.

How we converted to XHTML

ASP Ecommerce & Shopping Cart

Your own Web Site?

Read W3Schools
Hosting Tutorial

$15 Domain Name
Registration
Save $20 / year!

Advertise
at W3Schools

Only 0.5 CPM

SELECTED LINKS

University Online
Master Degree
Bachelor Degree

Web Software

The Future of
Web Development

Jobs and Careers

Web Security
Web Statistics
Web Standards

PARTNERS

W3Schools
TopXML
VisualBuilder
XMLPitstop
DevelopersDex
DevGuru
Programmers Heaven
The Code Project
Tek Tips Forum
ZVON.ORG
TopXML Search