<Validate Type="Range">

The Range validator prevents the form from being submitted unless the target control's value falls between MinimumValue and MaximumValue (inclusive). Use it for numeric ranges (quantities, ages, ratings) or date ranges (must be in the future, within a 30-day window, etc.).

Example

<AddForm>
  ...
  <table>
    <tr>
      <td>
        <Label For="txtQuantity" Text="Number of Tickets" />
        <TextBox Id="txtQuantity" DataField="Quantity" DataType="int32" />
        <Validate Type="Range" Target="txtQuantity" MinimumValue="1" MaximumValue="5"
                  DataType="Integer" Message="You can only order between 1 and 5 tickets" />
      </td>
    </tr>
    <tr>
      <td colspan="2">
        <AddButton Text="Place Order" />&nbsp;<CancelButton Text="Cancel" />
        <ValidationSummary />
      </td>
    </tr>
  </table>
</AddForm>

Properties

Property	Values	Default	Description
Type *	Range		Identifies this as a Range validator
Target *	control ID		ID of the control to validate
MinimumValue	string		Lowest allowed value (inclusive)
MaximumValue	string		Highest allowed value (inclusive)
CssClass	string		CSS class name(s) for styling the validator's error display
DataType	String Integer Double Date Currency	String	How the values should be parsed for comparison
Display	Static Dynamic	Dynamic	Whether the validator reserves layout space when no error is shown
EnableClientScript	True False	True	When True, validation runs in the browser as well as on the server
Height	size		Height of the validator's error display
Message	string		Text shown in the <ValidationSummary> when validation fails
Text	string		Text shown inline at the validator's location when validation fails
Width	size		Width of the validator's error display

* Required property

Deprecated Properties

These properties use ASP.NET inline styling and are no longer recommended for modern web development. Use the CssClass property to apply CSS classes or the Style property for inline CSS instead.

Property	Values	Description
BackColor	color name | #dddddd	Background color of the validator's error display
BorderColor	color name | #dddddd	Border color
BorderStyle	NotSet None Dotted Dashed Solid Double Groove Ridge Inset Outset	Border style
BorderWidth	size	Border width
Font-Bold	True False	Bold text
Font-Italic	True False	Italic text
Font-Names	string	Font family name
Font-Overline	True False	Overline text decoration
Font-Size	XX-Small X-Small Small Medium Large X-Large XX-Large or size	Font size
Font-Strikeout	True False	Strikethrough text decoration
Font-Underline	True False	Underline text decoration
ForeColor	color name | #dddddd	Text color. Note: the validator hard-codes red, bold text by default. If you set CssClass, XMP automatically clears ForeColor so your stylesheet's color rules take effect

Property Details

• Type: Set to Range to identify this as a Range validator.

• Target: The ID of the form control whose value should be checked.

• MinimumValue: The lowest allowed value, inclusive. Combine with MaximumValue to define the range.

• MaximumValue: The highest allowed value, inclusive.

• DataType: How the values should be parsed before comparison. Defaults to String (literal text comparison). For numeric or date ranges, set to Integer, Double, Date, or Currency so the comparison is type-aware. Tip: if you forget to set DataType for a numeric range, "10" will sort below "5" because they're compared as strings.

• Message: The error text shown in the <ValidationSummary> (if you have one) when validation fails. If no <ValidationSummary> is present, this text appears at the validator's location instead.

• Text: The text shown inline at the validator's location when validation fails. Used together with Message and <ValidationSummary>: a short inline marker (*, **, or an icon) at the validator + the full sentence in the summary block.

• Display: Whether the validator reserves layout space even when no error is shown. Dynamic (the default) collapses to no space until validation fails. Static always reserves space.

• EnableClientScript: When True (the default), the validator runs in the browser before the form is submitted, giving the user immediate feedback. Set to False to force server-side-only validation.