¿Cómo configurar el formato de máscara de texto de MaskedTextBox en C#?

En C#, el control MaskedTextBox brinda un procedimiento de validación para la entrada del usuario en el formulario, como fecha, números de teléfono, etc. O, en otras palabras, se usa para proporcionar una máscara que diferencia entre la entrada del usuario correcta e incorrecta. En el control MaskedTextBox, establece un valor que indica que los literales y los caracteres de aviso están incluidos en la string formateada presente en MaskedTextBox usando la propiedad TextMaskFormat proporcionada por el control MaskedTextBox. Esta propiedad tiene cuatro valores y estos valores se definen en la enumeración MaskFormat y los valores son:

• El valor ExcludePromptAndLiterals devuelve la entrada de texto proporcionada por el usuario.
• El valor de includeLiterals devuelve la entrada de texto proporcionada por el usuario y los caracteres literales definidos en la máscara.
• El valor de includePrompt devuelve la entrada de texto proporcionada por el usuario y las instancias del carácter de solicitud.
• El valor de includePromptAndLiterals proporciona la entrada de texto proporcionada por el usuario, los caracteres literales que se definen en la máscara y las instancias del carácter de solicitud.

El valor predeterminado de esta propiedad es Incluir Literales. Puede establecer esta propiedad de dos maneras diferentes:

1. Tiempo de diseño: es la forma más fácil de establecer el valor de la propiedad TextMaskFormat del control MaskedTextBox como se muestra en los siguientes pasos:

• Paso 1: cree un formulario de Windows como se muestra en la siguiente imagen:

  Visual Studio -> Archivo -> Nuevo -> Proyecto -> WindowsFormApp

  

• Paso 2: A continuación, arrastre y suelte el control MaskedTextBox desde la caja de herramientas en el formulario. Como se muestra en la siguiente imagen:

  

• Paso 3: Después de arrastrar y soltar, irá a las propiedades de MaskedTextBox y establecerá el valor de la propiedad TextMaskFormat del control MaskedTextBox como se muestra en la siguiente imagen:

  

  Producción:

  

2. Tiempo de ejecución: es un poco más complicado que el método anterior. En este método, puede establecer el valor de la propiedad TextMaskFormat del control MaskedTextBox mediante programación con la ayuda de la sintaxis dada:

public System.Windows.Forms.MaskFormat TextMaskFormat { get; set; }

Aquí, MaskFormat contiene los valores de la propiedad TextMaskFormat. Si el valor de esta propiedad no pertenece a la enumeración MaskFormat, generará una excepción InvalidEnumArgumentException . Los siguientes pasos muestran cómo establecer dinámicamente el valor de la propiedad TextMaskFormat del control MaskedTextBox:

• Paso 1: Crear un MaskedTextBox usando el constructor MaskedTextBox() proporcionado por la clase MaskedTextBox.

  // Creating a MaskedTextBox
  MaskedTextBox m = new MaskedTextBox();
  

• Paso 2: después de crear MaskedTextBox, establezca la propiedad TextMaskFormat de MaskedTextBox proporcionada por la clase MaskedTextBox.

  // Setting the TextMaskFormat property
  m.TextMaskFormat = MaskFormat.IncludeLiterals;
  

• Paso 3: Y por último agregue este control MaskedTextBox al formulario usando la siguiente declaración:

  // Adding MaskedTextBox control on the form
  this.Controls.Add(m);
  

  Ejemplo:

  using System; using System.Collections.Generic; using System.ComponentModel; using System.Data; using System.Drawing; using System.Linq; using System.Text; using System.Threading.Tasks; using System.Windows.Forms;    namespace WindowsFormsApp39 {    public partial class Form1 : Form {        public Form1()     {         InitializeComponent();     }        private void Form1_Load(object sender, EventArgs e)     {            // Creating and setting the          // properties of the Label         Label l1 = new Label();         l1.Location = new Point(413, 98);         l1.Size = new Size(176, 20);         l1.Text = " Example";         l1.Font = new Font("Bell MT", 12);            // Adding label on the form         this.Controls.Add(l1);            // Creating and setting the         // properties of Label         Label l2 = new Label();         l2.Location = new Point(242, 135);         l2.Size = new Size(126, 20);         l2.Text = "Phone number:";         l2.Font = new Font("Bell MT", 12);            // Adding label on the form         this.Controls.Add(l2);            // Creating and setting the          // properties of MaskedTextBox         MaskedTextBox m = new MaskedTextBox();         m.Location = new Point(374, 137);         m.Mask = "000000000";         m.Size = new Size(176, 20);         m.Name = "MyBox";         m.BorderStyle = BorderStyle.Fixed3D;         m.TextMaskFormat = MaskFormat.IncludeLiterals;         m.Font = new Font("Bell MT", 18);            // Adding MaskedTextBox         // control on the form         this.Controls.Add(m);     } } }

  Producción: