Click here to Skip to main content
Licence CPOL
First Posted 28 Apr 2008
Views 27,809
Downloads 473
Bookmarked 17 times

Phone TextBox Control with Built-in Phone Validator - ASP.NET Custom Control

By | 28 Apr 2008 | Article
Discussing the creation of custom Phone TextBox and its built-in PhoneValidator that validates a group of textboxes which represents three sections of a phone number. It inherits the BaseValidator and uses some new cool ASP.NET AJAX 3.5 features.
Library

Introduction

Sometimes it is troublesome to create a textbox for each section of a phone number and often, it requires a set of validators to validate a phone number that consists of three textboxes. In this case, as a developer, you will need to drag three textboxes to your page and drag a RequiredFieldValidator and a RegularExpressValidator for each textbox. Then, you need to specify "ControlToValidate", "Display", "ErrorMessage," "Text", ValidationGroup" and "ValidateExpression" (if it is a RegularExpression validator) properties for each validator. You could probably end up with some properties being set incorrectly after you went through all this trouble and try to test it. As a result of the time wasting experience, I decided to create a custom PhoneTextBox with built-in PhoneValidator control.

Background

After I decided to create such server controls, problems started floating above the surface. The first thing that I found out is how to create a validator that would validate multiple controls. Secondly, it is a known fact that ASP.NET validators can only show one error message. With the design that I have in mind, I need to find a way to somehow plug in additional error messages for each scenario. In this case, I will need to be able to show two kind of messages in this PhoneValidator, such as InvalidPhoneNumber and MissingPhoneNumber.

To cut a long story short, I eventually figured out how to do it. If you would like to know in details, please go to my blog.

Using the Code

The way to use this control is just like any other stardard ASP.NET server control. To make the drag and drop controls from your own assembly, you need to add the following line to the web.config file under system.web/pages/controls:

<add tagPrefix="Library" namespace="Library" assembly="Library" /> 

Here is an example:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
<style>
    #form {clear: both;}
    #form label {float: left;margin-right: 10px;}
    #form .phone {float: left;}
    #form br {float: left;}
    #form a {float: left;}
</style>
</head>
<body>
    <form id="form1" runat="server">
        <div id="form">
            <asp:scriptmanager id="ScriptManager1" runat="server"></asp:scriptmanager>
            <asp:validationsummary id="ValidationSummary1" 
			runat="server" validationgroup="test" />
            <label for="PhoneTextBox1">Phone</label>
            <library:phonetextbox id="PhoneTextBox1" 
		cssclass="phone" validationgroup="test" runat="server" 
		isrequired="True" /><br /><br />
            <asp:linkbutton id="LinkButton1" validationgroup="test" 
		runat="server" text="Submit" /> 
        </div>
    </form>
</body>
</html>   

Conclusion

I wish this small amount of coding will help you in saving your time to do other more important programming. If you like this article, then please remember to vote. If you have any suggestions, bugs to report, or enhancements, please share them with me! Thanks!

History

  • 04/29/2008 - Uploaded the first edition

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

Enoch Tsai

Software Developer (Senior)
Bibles for America
United States United States

Member



Sign Up to vote   Poor Excellent
Add a reason or comment to your vote: x
Votes of 3 or less require a comment

Comments and Discussions

 
You must Sign In to use this message board. (secure sign-in)
 
Search this forum  
 FAQ
    Noise  Layout  Per page   
  Refresh
GeneralCustom PhoneTextBox Control PinmemberJMWebstudios8:35 4 Nov '09  
GeneralRe: Custom PhoneTextBox Control PinmemberJMWebstudios8:53 4 Nov '09  
GeneralBug fixes PinmemberOriAlmog3:47 23 Oct '08  
Hi Enoch
Great project, really useful! Smile | :)
 
Just a couple of changes where needed to use the control in container controls and have mulitple instances of the control as follows
 
in CreateChildControls() of PhoneTextBox control
Change
  _tbxAreaCode.ID = "_tbxAreaCode"
  ...
To
  _tbxAreaCode.ID =  Me.ID + "_tbxAreaCode"
  ...
 
And replace all intances of
  Page.FindControl
to
  Parent.FindControl

GeneralRe: Bug fixes for Multiple Controls on Page PinmemberJMWebstudios8:52 4 Nov '09  
GeneralRe: Bug fixes for Multiple Controls on Page PinmemberLMoody11:15 1 Feb '10  
Generalwell I find this useless... PinmemberSeishin#23:12 28 Apr '08  
AnswerRe: well I find this useless... PinmemberEnoch Tsai5:29 29 Apr '08  

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Mobile
Web02 | 2.5.120529.1 | Last Updated 28 Apr 2008
Article Copyright 2008 by Enoch Tsai
Everything else Copyright © CodeProject, 1999-2012
Terms of Use
Layout: fixed | fluid