BaseValidator.ControlToValidate Property
Gets or sets the input control to validate.
Assembly: System.Web (in System.Web.dll)
<ThemeableAttribute(False)> <TypeConverterAttribute(GetType(ValidatedControlConverter))> Public Property ControlToValidate As String
Property Value
Type: System.StringThe input control to validate. The default value is String.Empty, which indicates that this property is not set.
Use the ControlToValidate property to specify the input control to validate. This property must be set to the ID of an input control for all validation controls except the CustomValidator control, which can be left blank. If you do not specify a valid input control, an exception will be thrown when the page is rendered. The ID must refer to a control within the same container as the validation control. It must be in the same page or user control, or it must be in the same template of a templated control.
The standard controls that can be validated are:
Note |
|---|
For an input control to be validated, the System.Web.UI.ValidationPropertyAttribute attribute must be applied to the control. |
All validation controls, except the RequiredFieldValidator control, will pass validation if the input control specified by the ControlToValidate property contains no text. If you are using a CustomValidator control, the client-side and server-side validation functions are not called either.
This property cannot be set by themes or style sheet themes. For more information, see ThemeableAttribute and ASP.NET Themes and Skins.
The following code example demonstrates how to use the ControlToValidate property to specify the input control to validate.
<%@ Page Language="VB" AutoEventWireup="False" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click If Page.IsValid Then MessageLabel.Text = "Page submitted successfully." Else MessageLabel.Text = "There is an error on the page." End If End Sub </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>Validator Example</title> </head> <body> <form id="form1" runat="server"> <h3>Validator Example</h3> Enter a number from 1 to 10. <asp:textbox id="NumberTextBox" runat="server"/> <asp:rangevalidator id="NumberCompareValidator" controltovalidate="NumberTextBox" enableclientscript="False" type="Integer" display="Dynamic" errormessage="Please enter a value from 1 to 10." maximumvalue="10" minimumvalue="1" text="*" runat="server"/> <asp:requiredfieldvalidator id="TextBoxRequiredValidator" controltovalidate="NumberTextBox" enableclientscript="False" display="Dynamic" errormessage="Please enter a value." text="*" runat="server"/> <br /><br /> <asp:button id="SubmitButton" text="Submit" runat="server"/> <br /><br /> <asp:label id="MessageLabel" runat="server"/> <br /><br /> <asp:validationsummary id="ErrorSummary" runat="server"/> </form> </body> </html>
Available since 1.1
