VB.NET TextBox Validation Control

• Download demo project - 13.1 Kb
• Download source - 14.2 Kb

Introduction

The TextBoxValidator control is a control that is inherited from the .NET Framework TextBox. This control will ensure that the information entered into the text box is valid for that field which it represents. The validation of the data is accomplished by sending the text value through the Regular Expression Match class. If the property Validation which holds the regular expression pattern is changed at run time, the the control will revalidate the data in the text box if it is not empty.

Using the code

To use the TextBoxValidate demo program, make sure both TextBoxValidateHost.exe and TextBoxValidate.dll are both in the same directory, and double click on the TextBoxValidateHost program. To install the control into your environment, open the Toolbox. Then select the tab you want the control to appear in, right click, and select “Add\Remove Items…”. When the “Customize Toolbox” window appears, select the “Browse…” button. When the “Open” dialog box appears, navigate to where you have placed the TextBoxValidate.dll and click the Open button. Then back in the “Customize Toolbox” window, click on the OK button. Now when you want to use the TextBoxValidator control, just drop it on a form and set the properties.

The icon displayed in the Toolbox window.

The properties added for the TextBoxValidator control.

The following four properties control the validation part of the control: ErrorBackColor and ErrorForeColor control the background and foreground colors of the text box when a validation error has occurred. Required is the property that will allow a field to be left blank (False) or must have a valid value (True) to be able to move on. The last property Validation is where the Regular Expression is placed to control the values allowed in the text box. You must be careful when entering a value for Validation so that what you want to validate is correctly defined by the regular expression. For example, if you want to validate a text field for a US phone number and selected the one Microsoft gives in the Regular Expression Editor, “((\(\d{3}\) ?)|(\d{3}-))?\d{3}-\d{4}”, you will find that the expression will not only match (555) 555-1234 but also (555) 555-12345 and others. I used “^((\(\d{3}\) ?)\d{3}-\d{4})$|^(\d{3}-\d{3}-\d{4})$” in the demo program which matched a US phone number and nothing else, so please be careful. Also, if at run time the regular expression is modified, the control will validate the data in the text box if it contains any data.

Regular Expression Editor: You may type any regular expression in the Validation Expression text box shown above.

Look in the Microsoft documentation and the Web for information on regular expressions. The documents “Regular Expression Language Elements”, “Regular Expressions as a Language”, “.NET Framework Regular Expressions” and others can be found in the Microsoft documentation.

Revision History

• April 12, 2005: Article first published.
• April 23, 2005: Modified the code so that if the Validation pattern is changed at run time, it validates the data. A suggestion made by Oleg A. Lukin.

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here