XMod Pro Documentation

# <Validate type="Range">

The Validate tag whose type is set to "range" is referred to as a Range Validator and is used to ensure the value of the target control falls within the specified range of values. This can be used, for example, to ensure that only a limited number of tickets can be purchased - that the number of tickets ordered is at least one but not more than five.

# Syntax

<Validate 
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge| Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    DataType="String|Integer|Double|Date|Currency"
    Display="Static|Dynamic"
    EnableClientScript="True|False" 
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium| Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    MaximumValue="string"
    Message="string"
    MinimumValue="string"
    Target="string"
    Text="string"
    Type="Range"
    Width="size"
/>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# Remarks

When the Type attribute is set to Range, the control prevents the form from being submitted if its associated control's value does not match the range specified using the "MaximumValue" and "MinimumValue" attributes. You associate a control with the <Validate> tag by setting its Target attribute to the ID of the control you wish to validate. The Message attribute is the text that will be displayed to the user when validation fails. If you are using the <ValidationSummary> tag, then you can also supply a "text" attribute. When validation fails, the "text" will be displayed where your <Validate> tag is and the "message" will be displayed in the <ValidationSummary>.

  • BackColor: Color of the background of the control.

  • BorderColor: Color of the border around the control.

  • BorderStyle: Style of the border around the control. Defaults to NotSet.

  • BorderWidth: Width of the border around the control, specified in units

  • CssClass: Name of the Cascading Style Sheets (CSS) class used to style this control.

  • DataType: Use this property to choose the datatype to check for. DataTypes include String, Integer, Double, Date, Currency. Default is String.

  • Display: This attribute determines if the <Validate> tag will reserve space for its message in the page layout - typically resulting in blank space in your form - or whether it will dynamically allocate the space for the message when validation fails. Defaults to Dynamic display.

  • EnableClientScript: Use the EnableClientScript property to specify whether client-side validation is enabled. Defaults to True.

  • Font Properties: A series of attributes such as font-bold, font-size, etc. that allow you to control how the text in the control is displayed. More

  • ForeColor: Sets the foreground color (typically the color of the text) of the control.

  • Height: Height of the control, specified in units.

  • MaximumValue: Sets the maximum value of the validation range.

  • Message: This is the text that will be displayed to the user, when validation fails. If you are using the <ValidationSummary>, then this is the message that will be displayed in the <ValidationSummary> when validation fails.

  • MinimumValue: Sets the minimum value of the validation range.

  • Target: Set this attribute to the ID of the control you wish to validate.

  • Text: If you are using the <ValidationSummary> tag, then you can also supply a "text" attribute. When validation fails, the "text" will be displayed where your <Validate> tag is and the "message" will be displayed in the <ValidationSummary>.

  • Type: When the "type" attribute is set to Range, the control prevents the form from being submitted if its associated control's value does not match the range specified using the "MaximumValue" and "MinimumValue" attributes.

  • Width: Width of the control in units.

# 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" 
          Message="You can only order between 1 and 5 tickets" DataType="Integer" />
      </td>
    </tr>
    <tr>
      <td colspan="2">
        <AddButton Text="Place Order" />&nbsp;<CancelButton Text="Cancel" />
        <ValidationSummary />
      </td>
    </tr>
  </table>
</AddForm>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

← <Validate type="RegEx"> →