# <Validate type="checkbox">

The Validate tag whose type is set to "checkbox" is referred to as a CheckBox Validator and is used to ensure the user either checks or does not check a checkbox control.

# 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"
    Display="Static|Dynamic"
    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"
    MustBeChecked="True|False"
    Target="string"
    Text="string"
    Type="Checkbox"
    Width="size" 
/> 

# Remarks

The Checkbox validator is one type of the <Validate> tag. When the "type" attribute is set to Checkbox, the control prevents the form from being submitted if its associated checkbox control is checked or un-checked (depending on settings). 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 <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.

• 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 (../unit-types.md)

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

• 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.

• 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.

• Message: This is the text that will be displayed to the user, in the <ValidationSummary>, when validation fails.

• MustBeChecked: True/False, default value is True. Determines what constitutes a valid state for the control. If set to True, then the user must check the box for the control to be valid. If the property is set to False, the user must un-check the control for it to be valid.

• 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 Checkbox, the control prevents the form from being submitted if its associated checkbox control is checked or un-checked (depending on settings).

• Width: Width of the control in units.

# Example

<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="chkAgree" Text="I Agree to the Terms of Service" /> 
          <Checkbox Id="chkAgree" DataField="Agree" DataType="boolean" />
          <Validate Type="checkbox" Target="chkAgree" MustBeChecked="True" 
                    Message="You must agree to the terms" />
        </td>
      </tr>
      <tr>
        <td colspan="2">
          <AddButton text="Add" />&nbsp;<CancelButton text="Cancel" />
        </td>
      </tr>
    </table>
</AddForm>