The Validate tag whose type is set to "checkboxlist" is referred to as a CheckBoxList Validator and is used to ensure the user checks at least one box in the list. NOTE: This validator runs on the server only. A form must pass all client-side validation and be submitted to the server before this validation will trigger.
<Validate
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge| Inset|Outset"
BorderWidth="size"
CssClass="string"
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"
Message="string"
Target="string"
Text="string"
Type="CheckboxList"
Width="size"
/>
The checkboxlist validator is one type of the <validate>
tag. When the "type" attribute is set to checkboxlist, the control prevents the form from being submitted if its associated control does not have any boxes ticked. 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>
. The "display" attribute determines if the 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. The <validate>
tag defaults to Dynamic display.
Back to top
<addform>
<submitcommand commandtext="INSERT INTO Users(FirstName,
LastName) VALUES(@FirstName, @LastName)" />
<table>
<tr>
<td>
<label for="txtFirstName" text="First Name" />
<textbox id="txtFirstName" datafield="FirstName"
datatype="string" />
</td>
</tr>
<tr>
<td>
<label for="txtLastName" text="Last Name" />
<textbox id="txtLastName" datafield="LastName"
datatype="string" />
</td>
</tr>
<tr>
<td>
<label for="cblColors" text="Favorite Color(s)" />
<checkbox id="cblColors" datafield="FavColors"
datatype="string" />
<validate type="checkboxlist" target="cblColors" text="**" message="Everyone has a favorite color. What's yours? (Select at least one)" />
</td>
</tr>
<tr>
<td colspan="2">
<addbutton text="Add"/> <cancelbutton
text="Cancel"/>
<validationsummary />
</td>
</tr>
</table>
</addform>