BaseValidator::ControlToValidate Property

 

Gets or sets the input control to validate.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public:
[ThemeableAttribute(false)]
[TypeConverterAttribute((ValidatedControlConverter^::typeid))]
property String^ ControlToValidate {
	String^ get();
	void set(String^ value);
}

Property Value

Type: System::String^

The 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:

System_CAPS_noteNote

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.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: