Return to the menu   Select another DES Module

Demonstrates the CompareToValueValidator with different types of data entry controls

The CompareToValueValidator compares a field’s value to another value that you supply. It is data type sensitive, converting a string to a specific data type before the comparison. (If it cannot convert, it does not report an error. Use the DataTypeCheckValidator to check for data type format errors.)

Specify the ID of the field in the ControlIDToEvaluate property.

Unless the data entry control is DES data type entry textbox (like DateTextBox or IntegerTextBox), always remember to set the DataType property. It supports these values: “String-Case Insensitive”, “Integer”, “Double”, “Date”, “Currency”, “Currency with Symbol”, “Positive Integer”, “Positive Double”, “Positive Currency”, and “Positive Currency with Symbol”. DES data type entry textboxes automatically supply their own data type.

Use the Operator property for the comparison operator. It supports "Equals", "NotEquals", "LessThan", "LessThanEqual", "GreaterThan", and "GreaterThatEqual".

Use ValueToCompare for the value. It takes a string which should reflect the same data type you specified, following the culture format set in PeterBlum.DES.Globals.WebFormDirector.CultureInfo. Alternatively, you can programmatically assign a native type, like an integer or DateTime, to the ValueToCompareAsNative property and it will convert the value into a correctly formatted string.

The ErrorMessage and SummaryErrorMessage properties supports the token "{VALUETOCOMPARE}". It is replaced by the value in the ValueToCompare property.


Controls

Textbox used for integer entry

Enter an integer. To be valid, it must be less than 50.



IntegerTextBox

Any of DES's data type entry textboxes (integer, decimal, date, etc) do not require setting the DataType property.
Enter an integer. To be valid, it must be less than 50.



ListBox

The validator evaluates the ListItem.Value property, not ListItem.Text. So here it compares to "1" and "2" instead of "Group 1" and "Group 2".



DES Calendar

While there are other features of the Calendar control to exclude dates, this example requires selecting only dates prior to today. In Page_Load, Today's date is assigned to CompareToValueValidator.ValueToCompareAsNative.
When using the Calendar, the CompareToValueValidator.DataType property can be omitted.

Previous Month
Next Month
September 2020
SunMonTueWedThuFriSat
303112345
6789101112
13141516171819
20212223242526
27282930123
45678910
Clear


See also:
On DateTextBoxes
On TimeOfDayTextBox and DurationTextBox

 

Source Code (C#)

<script runat="server">
protected void Page_Load(object sender, EventArgs e) { CompareToValueValidator4.ValueToCompareAsNative = DateTime.Today; } protected void Button1_Click(object sender, EventArgs e) { if (PeterBlum.DES.Globals.WebFormDirector.IsValid) { // save your data here } }
</script> <h2>Textbox used for integer entry</h2> Enter an integer. To be valid, it must be less than 50.<br/><br/> <des:TextBox ID="TextBox1" runat="server" ></des:TextBox> <des:CompareToValueValidator ID="CompareToValueValidator1" runat="server" ControlIDToEvaluate="TextBox1" DataType="Integer" Operator="LessThan" ValueToCompare="50" ErrorMessage="Less than {VALUETOCOMPARE}."> <ErrorFormatterContainer> <des:TextErrorFormatter Display="Dynamic" /> </ErrorFormatterContainer> </des:CompareToValueValidator> <des:DataTypeCheckValidator ID="DataTypeCheckValidator1" runat="server" ControlIDToEvaluate="TextBox1" DataType="Integer" ErrorMessage="Enter an integer."> <ErrorFormatterContainer> <des:TextErrorFormatter Display="Dynamic" /> </ErrorFormatterContainer> </des:DataTypeCheckValidator> <br/><br/> <h2>IntegerTextBox</h2> Any of DES's data type entry textboxes (integer, decimal, date, etc) do not require setting the <span class="PropertyName">DataType</span> property.<br/> Enter an integer. To be valid, it must be less than 50.<br/><br/> <des:IntegerTextBox ID="IntegerTextBox1" runat="server" ></des:IntegerTextBox> <des:CompareToValueValidator ID="CompareToValueValidator2" runat="server" ControlIDToEvaluate="IntegerTextBox1" Operator="LessThan" ValueToCompare="50" ErrorMessage="Less than {VALUETOCOMPARE}."> <ErrorFormatterContainer> <des:TextErrorFormatter Display="Dynamic" /> </ErrorFormatterContainer> </des:CompareToValueValidator> <des:DataTypeCheckValidator ID="DataTypeCheckValidator2" runat="server" ControlIDToEvaluate="IntegerTextBox1" ErrorMessage="Enter an integer."> <ErrorFormatterContainer> <des:TextErrorFormatter Display="Dynamic" /> </ErrorFormatterContainer> </des:DataTypeCheckValidator> <br/><br/> <h2>ListBox</h2> The validator evaluates the <span class="PropertyName">ListItem.Value</span> property, not <span class="PropertyName">ListItem.Text</span>. So here it compares to "1" and "2" instead of "Group 1" and "Group 2".<br/><br/> <asp:ListBox ID="ListBox1" runat="server"> <asp:ListItem Value="1">Group 1</asp:ListItem> <asp:ListItem Value="2">Group 2</asp:ListItem> </asp:ListBox> <des:CompareToValueValidator ID="CompareToValueValidator3" runat="server" ControlIDToEvaluate="ListBox1" ErrorMessage="Must be 1" ValueToCompare="1" Operator="Equal" DataType="Integer" /> <br/><br/> <h2>DES Calendar</h2> While there are other features of the <a href="../../../DateAndTime/Menu.aspx?Topic=Calendars">Calendar</a> control to exclude dates, this example requires selecting only dates prior to today. In Page_Load, Today's date is assigned to <span class="PropertyName">CompareToValueValidator.ValueToCompareAsNative</span>.<br/> When using the Calendar, the <span class="PropertyName">CompareToValueValidator.DataType</span> property can be omitted.<br/><br/> <des:Calendar ID="Calendar1" runat="server" > <ClearCommand ShowField="RecommendedRow" /> </des:Calendar> <des:CompareToValueValidator ID="CompareToValueValidator4" runat="server" ControlIDToEvaluate="Calendar1" Operator="LessThan" ErrorMessage="Less than {VALUETOCOMPARE}"> </des:CompareToValueValidator> <br/><br/> See also:<br/> <a href="../../../DateAndTime/DateTextBoxes/Validators.aspx" class="ControlClass">On DateTextBoxes</a><br/> <a href="../../../DateAndTime/TimeTextBoxes/Validators.aspx" class="ControlClass">On TimeOfDayTextBox and DurationTextBox</a><br/> <br/> <des:Button ID="Button1" runat="server" Text="Submit" OnClick="Button1_Click"></des:Button> 

Return to the menu   Select another DES Module