Getting Started with Windows Forms MaskedEditBox control

11 Oct 20223 minutes to read

This section briefly describes how to create a new Windows Forms project in Visual Studio and how to add the WinForms MaskedTextBox control with its basic functionalities.

Assembly deployment

Refer to the Control Dependencies section to get the list of assemblies or details of NuGet package that needs to be added as a reference to use the control in any application.

Refer to this documentation to find more details about installing NuGet packages in a Windows Forms application.

Adding the MaskedEditBox control via designer

The following steps describe how to create the MaskedEditBox control via designer:

1. Create a new Windows Forms application in Visual Studio.

2. Add the MaskedEditBox control to an application by dragging it from the toolbox to design view. The following dependent assembly will be added automatically:

   • Syncfusion.Shared.Base

1. Set the symbols in the Mask property for the control. This property controls the behavior of control at run time.

If no mask is specified, the control will behave the same as a standard Windows Forms TextBox control.

Adding the MaskedEditBox control via code

The following steps describe how to create the MaskedEditBox control programmatically:

1. Create a C# or VB application via Visual Studio.

2. Add the following assembly reference to the project:

   • Syncfusion.Shared.Base

3. Include the required namespace.

   C#

   using Syncfusion.Windows.Forms.Tools;

   VB.NET

   Imports Syncfusion.Windows.Forms.Tools

4. Create an instance of the MaskedEditBox control, and then add it to the form.

   C#

   private Syncfusion.Windows.Forms.Tools.MaskedEditBox maskedEditBox1;
   this.maskedEditBox1=new MaskedEditBox();
   this.Controls.Add(this.maskedEditBox1);

   VB.NET

   Private maskedEditBox1 As Syncfusion.Windows.Forms.Tools.MaskedEditBox
   Me.maskedEditBox1 = New MaskedEditBox()
   Me.Controls.Add(Me.maskedEditBox1)

Mask settings

You can set some common symbols for the Mask property. For example, the symbols are set as “##:##”.

NOTE

The # symbol allows numeric entry only in that position.

Examples of some common masks are,

Mask	Usage
###-##-####	US Social security number mask( the '-' symbol is literal). Example 222-22-2222.
(###) ### ####	US Telephone number mask. Example [phone].
##/##/####	Short date mask. Example 04/14/2005.
##:##	Short time mask. Example 12:24.
>?<????????????	First name or last name. The first letter is uppercase, and the other all letters are lowercase. Example: Syncfusion.

C#

// The mask string.
this.maskedEditBox1.Mask = ">?<???? ??????";
this.maskedEditBox1.Location = new System.Drawing.Point(70, 29);

VB.NET

' The mask string.
Me.maskedEditBox1.Mask = ">?<???? ??????"
Me.maskedEditBox1.Location = New System.Drawing.Point(70, 29);