Telerik UI for WinForms


RadMaskedEditBox descends from RadTextBox and so has the same properties, methods and events. The significant properties unique to RadMaskedEditBox are:

  • MaskType: This property determines how masks are interpreted by the control. Valid values are:

    • None: the control acts like a text box.

    • Numeric: you can define standard numeric masks.

    • Standard: you can define standard masks

    • Regex: you can define Regex expressions as masks.

    • IP: predefined mask for IP input.

    • Email: predefined mask for email validation.

    • DateTime: predefined mask for DateTime input.

    • FreeFormatDateTime: with that mask type end-users are able to enter a date and time in a wide range of formats without having to conform to a specific mask. In the following article you can find more information how this DateTime parsing logic works: Pasing Dates

  • Mask: A string of characters that constrain user input. The Mask property may contain literals and special mask characters. The MaskType determines how the mask characters are interpreted. Use the backslash "\" character to escape any mask characters so that they display as literals. At runtime, any blank space occupied by a Mask character is displayed as the PromptChar property character.

  • PromptChar: This property represents the character displayed in any blank space defined by a Mask character. By default the character is an underscore "_".

  • Culture: This property allows you to set the current language and culture from a drop down list at design-time or assign a new CultureInfo instance at run-time.

    editors-maskededitbox-properties-and-events 001
    [C#] Copy imageCopy
    this.radMaskedEditBox1.MaskType = Telerik.WinControls.UI.MaskType.DateTime;
    this.radMaskedEditBox1.Mask = "d";
    this.radMaskedEditBox1.Culture = new System.Globalization.CultureInfo("de-de");
    [VB.NET] Copy imageCopy
    Me.RadMaskedEditBox1.MaskType = Telerik.WinControls.UI.MaskType.DateTime
    Me.RadMaskedEditBox1.Mask = "D"
    Me.RadMaskedEditBox1.Culture = New System.Globalization.CultureInfo("de-DE")
  • Value: This property returns user input without the formatting characters. If you want the input and the formatting characters, use the Text property.

  • NullText: determines the text that will be displayed, when the Value of the control is null.

MaskType and Mask Examples



User Input

Displayed as Example


\# ###


# 12_











1 1 2007



MMM dd

Navigate with

Dec 1


RadMaskedEditBox allows you to handle ValueChanging and ValueChanged events. Examine the Text and Value properties to determine user entry with mask and without mask, respectively. ValueChanging also passes a CancelEventArgs parameter containing a Cancel property. When Cancel is set to true the value is not allowed to change.