How to: Add and Configure a CustomValidator Control 

Use the CustomValidator control to perform customized validation on input data in TextBox and SelectionList controls.

NoteNote

If the user leaves the targeted control blank, it passes the custom validation test. To force the user to enter a value, add a RequiredFieldValidator control as well. For details, see How to: Add and Configure a RequiredFieldValidator Control.

To validate with a CustomValidator control

  1. Add a CustomValidator control to the form that contains the target control.

  2. Set the ControlToValidate property to the ID of the control to validate.

  3. Set the ErrorMessage property to a string to display if the target control fails validation.

    NoteNote

    If you enter a string into the Text property, the CustomValidator control displays that text when an error occurs. If the Text property is left empty, the CustomValidator control displays the string defined in the ErrorMessage property.

  4. Switch to Design view, and then double-click the CustomValidator control.

    Visual Studio opens the code editor with an empty validation method.

  5. Create the handler. For details, see Introduction to the CustomValidator Control.

See Also

Tasks

How to: Add and Configure a CompareValidator Control
How to: Add and Configure a RangeValidator Control
How to: Add and Configure a RegularExpressionValidator Control
How to: Add and Configure a RequiredFieldValidator Control
How to: Add and Configure a ValidationSummary Control
Testing Validity Programmatically for Web Server Controls

Concepts

Introduction to the Validation Controls