MaskedTextBox In C#

Mahesh Chand

C#Windows Formsmasked textboxMaskedTextBox in C#

18 Comments

Join the conversation! Your thoughts help the community grow.

Eduardo Fernandez6y ago
How do you control is the date value is correct?. I downloaded the zip file, run it, and I can enter any numeric values into the date field, and the program did not detect it. Examples: 45/52/2020. Thanks...
- Eduardo Fernandez6y ago
  I meaning the first MaskedTextBox created in the Designer (maskedTextBox1).
Rade Mikin8y ago
How to limit input to C # 6.0 in textBox.text only positive and negative integers and decimal numbers and not allow the input of letters or special characters, as in the case 0.12 / -0.121,12 / -1.12 123.45 / -123.45 123,456.78 / -123,456.78 1,234,567,890.12 / - 1,234,567,890.12 1 / -1 123 / -123 123,456,789.12 / -123,456,789.12
Rade Mikin8y ago
How to limit input to C # 6.0 in textBox.text only positive and negative integers and decimal numbers and not allow the input of letters or special characters, as in the case
Lijo Jose12y ago
how to set focus to a masked texbox... In my case txtMasked.focus() doesn't works..
Jair Souza12y ago
Como ocultar a mascara em tempo de execu??o ?
tri lai minh13y ago
thank you!
jackson kumar13y ago
Thanks Sir
jackson kumar13y ago
Thanks Sir
jackson kumar13y ago
Thanks Sir
jackson kumar13y ago
Thanks Sir
jackson kumar13y ago
Thanks Sir
jackson kumar13y ago
Thanks Sir
jackson kumar13y ago
Thanks Sir
jackson kumar13y ago
Thanks Sir
Ravi Kumar14y ago
How we can set the value of 1 to 64 interger value in the maskedtextbox? Means user can only enter the 1 to 64 interger value in the textbox.
Tania Emmerechts16y ago
Hi everybody, I'm using a masked textbox for my Date like this : 01/12/2010 Now the problem is, when the user uses a date with a leading 0, the masked textbox gives this 11/22/010_ So it skipped the leading 0 althought it is correct in my database. This is the code I use to fill the masked textbox : mtbShipDate.Text = Convert.ToString(dataRowData["ShipDate"]); Please can somebody help me? Thanks, Tania
Mayur Gujrathi16y ago
I want to set date format as dd/mm/yyyy how can we do it. when i write maskedtextbox1.text=datetime.now.tostring it is getting format as mm/dd/yyyy

A MaskedTextBox control provides a validation mechanism for user input on a Form. For example, if you want a TextBox to accept a date in mm/dd/yyyy format, you can set masking in the MaskedTextBox.

In this article, I will discuss how to create a MaskedTextBox control in Windows Forms at design-time as well as run-time. After that, I will continue discussing various properties and methods available for the MaskedTextBox control.

Creating a MaskedTextBox

We can create a MaskedTextBox control using a Forms designer at design-time or using the MaskedTextBox class in code at run-time (also known as dynamically).

To create a MaskedTextBox control at design-time, you simply drag and drop a MaskedTextBox control from Toolbox to a Form in Visual Studio. After you drag and drop a MaskedTextBox on a Form, the MaskedTextBox looks like Figure 1. Once a MaskedTextBox is on the Form, you can move it around and resize it using mouse and set its properties and events.

Figure 1

Creating a MaskedTextBox control at run-time is merely a work of creating an instance of MaskedTextBox class, setting its properties and adding MaskedTextBox class to the Form controls.

The first step to create a dynamic MaskedTextBox is to create an instance of MaskedTextBox class. The following code snippet creates a MaskedTextBox control object.

MaskedTextBox dynamicMaskedTextBox = newMaskedTextBox();

In the next step, you may set properties of a MaskedTextBox control. The following code snippet sets background color, foreground color, Text, Name, and Font properties of a MaskedTextBox.

dynamicMaskedTextBox.BackColor = Color.Red;
dynamicMaskedTextBox.ForeColor = Color.Blue;
dynamicMaskedTextBox.Text = "I am Dynamic MaskedTextBox";
dynamicMaskedTextBox.Name = "DynamicMaskedTextBox";
dynamicMaskedTextBox.Font = newFont("Georgia", 16);

Once a MaskedTextBox control is ready with its properties, the next step is to add the MaskedTextBox control to the Form. To do so, we use Form.Controls.Add method. The following code snippet adds a MaskedTextBox control to the current Form.

Controls.Add(dynamicMaskedTextBox);

Setting MaskedTextBox Properties

After you place a MaskedTextBox control on a Form, the next step is to set properties.

The easiest way to set properties is from the Properties Window. You can open Properties window by pressing F4 or right click on a control and select Properties menu item. The Properties window looks like Figure 2.

Figure 2

Location, Height, Width, and Size

The Location property takes a Point that specifies the starting position of the MaskedTextBox on a Form. The Size property specifies the size of the control. We can also use Width and Height property instead of Size property. The following code snippet sets Location, Width, and Height properties of a MaskedTextBox control.

dynamicMaskedTextBox.Location = newPoint(20, 150);
dynamicMaskedTextBox.Height = 40;
dynamicMaskedTextBox.Width = 300;

Background, Foreground, BorderStyle

BackColor and ForeColor properties are used to set background and foreground color of a MaskedTextBox respectively. If you click on these properties in Properties window, the Color Dialog pops up.

Alternatively, you can set background and foreground colors at run-time. The following code snippet sets BackColor and ForeColor properties.

dynamicMaskedTextBox.BackColor = Color.Red;
dynamicMaskedTextBox.ForeColor = Color.Blue;

You can also set borders style of a MaskedTextBox by using the BorderStyle property. The BorderStyle property is represented by a BorderStyle enumeration that has three values – FixedSingle, Fixed3D, and None. The default value of border style is Fixed3D. The following code snippet sets the border style of a MaskedTextBox to FixedSingle.

dynamicMaskedTextBox.BorderStyle = BorderStyle.FixedSingle;

Name

Name property represents a unique name of a MaskedTextBox control. It is used to access the control in the code. The following code snippet sets and gets the name and text of a MaskedTextBox control.

dynamicMaskedTextBox.Name = "DynamicMaskedTextBox";
string name = dynamicMaskedTextBox.Name;

Text, TextAlign, and TextLength

Text property of a MaskedTextBox represents the current text of a MaskedTextBox control. The TextAlign property represents text alignment that can be Left, Center, or Right. The TextLength property returns the length of a MaskedTextBox contents.

The following code snippet sets the Text and TextAlign properties and gets the size of a MaskedTextBox control.

dynamicMaskedTextBox.Text = "I am Dynamic MaskedTextBox";
dynamicMaskedTextBox.TextAlign = HorizontalAlignment.Center;
int size = dynamicMaskedTextBox.TextLength;

Font

Font property represents the font of text of a MaskedTextBox control. If you click on the Font property in Properties window, you will see Font name, size and other font options. The following code snippet sets Font property at run-time.

dynamicMaskedTextBox.Font = newFont("Georgia", 16);

Maximum Length

You can restrict the number of characters in a MaskedTextBox control by setting MaxLength property. The following code snippet sets the maximum length of a MaskedTextBox to 50 characters.

dynamicMaskedTextBox.ReadOnly = true;
dynamicMaskedTextBox.MaxLength = 50;

Masking Related Properties

Mask

Masks the default property and represents the format of the input can be accepted by a control. We can set Mask property by clicking on the control and click on the little handler and select Set Mask link as you can see in Figure 3.

Figure 3

Set Mask launches Input Mask dialog where we can select a mask and you can see its data format and also set the validation type. See Figure 4.

Figure 4

The following code snippet sets the Mask property at run-time.

dynamicMaskedTextBox.Mask = "00/00/0000";

Here is a list and description of masking characters.

0 – Digit, required. Value between 0 and 9.
9 – Digit or space, optional.
# - Digit or space, optional. If this position is blank in the mask, it will be rendered as a space in the Text property.
L - Letter, required. Restricts input to the ASCII letters a-z and A-Z.
? - Letter, optional. Restricts input to the ASCII letters a-z and A-Z.
& - Character, required.
C - Character, optional. Any non-control character.
A - Alphanumeric, required.
a - Alphanumeric, optional.
. - Decimal placeholder.
, - Thousands placeholder.
: - Time separator.
/ - Date separator.
$ - Currency symbol.
< - Shift down. Converts all characters that follow to lowercase.
> - Shift up. Converts all characters that follow to uppercase.
| - Disable a previous shift up or shift down.
\ - Escape. Escapes a mask character, turning it into a literal. "\\" is the escape sequence for a backslash.

All other characters - Literals. All non-mask elements will appear as themselves within MaskedTextBox. Literals always occupy a static position in the mask at run time, and cannot be moved or deleted by the user.

MaskFull

MaskFull property represents if the mask values are completed.

if (maskedTextBox1.MaskFull){}

BeepOnError

If set true, the system beep is generated when incorrect values are entered.

dynamicMaskedTextBox.BeepOnError = true;

Summary

A MaskedTextBox control accepts user input on a Form. In this article, we discussed how to create a MaskedTextBox control in Windows Forms at design-time as well as run-time. After that, we saw how to use various properties and methods.