C# | Clase MaskedTextBox

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. La clase MaskedTextBox se usa para representar el cuadro de texto enmascarado de Windows y también proporciona diferentes tipos de propiedades, métodos y eventos. Se define en el espacio de nombres System.Windows.Forms .
Esta versión mejorada de clase del control TextBox admite una sintaxis declarativa para recibir o rechazar la entrada del usuario y cuando este control se muestra en tiempo de ejecución, representa la máscara como una secuencia de caracteres de solicitud y caracteres literales opcionales. En C#, puede crear un MaskedTextBox en el formulario de Windows de dos maneras diferentes:

1. Design-Time: Es la forma más fácil de crear un 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 hasta el formulario.

  • Paso 3: Después de arrastrar y soltar, irá a las propiedades del control MaskedTextBox para modificar MaskedTextBox según sus requisitos.

    Producción:

2. Tiempo de ejecución: es un poco más complicado que el método anterior. En este método, puede crear un control MaskedTextBox mediante programación con la ayuda de la sintaxis proporcionada por la clase MaskedTextBox. Los siguientes pasos muestran cómo configurar la creación de MaskedTextBox dinámicamente:

  • Paso 1: Crear un control MaskedTextBox usando el constructor MaskedTextBox() proporcionado por la clase MaskedTextBox.
    // Creating a MaskedTextBox control
    MaskedTextBox mbox = new MaskedTextBox(); 
    
  • Paso 2: después de crear el control MaskedTextBox, establezca la propiedad del control MaskedTextBox proporcionada por la clase MaskedTextBox.
    // Setting the properties 
    // of MaskedTextBox
    mbox.Location = new Point(374, 137); 
    mbox.Mask = "000000000"; 
    mbox.Size = new Size(176, 20); 
    mbox.Name = "MyBox"; 
    mbox.Font = new Font("Bauhaus 93", 18); 
    
  • 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(mbox); 
    

    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 WindowsFormsApp36 {
      
    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("Bauhaus 93", 12);
      
            // Adding label on the form
            this.Controls.Add(l1);
      
            // Creating and setting the
            // properties of the 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("Bauhaus 93", 12);
      
            // Adding label on the form
            this.Controls.Add(l2);
      
            // Creating and setting the
            // properties of the MaskedTextBox
            MaskedTextBox mbox = new MaskedTextBox();
            mbox.Location = new Point(374, 137);
            mbox.Mask = "000000000";
            mbox.Size = new Size(176, 20);
            mbox.Name = "MyBox";
            mbox.Font = new Font("Bauhaus 93", 18);
      
            // Adding MaskedTextBox
            // control on the form
            this.Controls.Add(mbox);
        }
    }
    }

    Producción:

Constructor

Constructor Descripción
Cuadro de texto enmascarado() Este constructor se utiliza para inicializar una nueva instancia de la clase MaskedTextBox.
MaskedTextBox (Proveedor de texto enmascarado) Este constructor se usa para inicializar una nueva instancia de la clase MaskedTextBox usando el proveedor de lenguaje de máscara personalizado especificado.
Cuadro de texto enmascarado (string) Este constructor se usa para inicializar una nueva instancia de la clase MaskedTextBox usando la máscara de entrada especificada.

Propiedades

Propiedad Descripción
solo ascii Obtiene o establece un valor que indica si el control MaskedTextBox acepta caracteres fuera del juego de caracteres ASCII.
Tamaño automático Esta propiedad se usa para obtener o establecer un valor que indica si el control cambia de tamaño según su contenido.
BackColor Esta propiedad se utiliza para obtener o establecer el color de fondo del control.
Estilo de borde Esta propiedad indica el estilo del borde del control.
Fuente Esta propiedad se usa para obtener o establecer la fuente del texto que muestra el control.
Color primario Esta propiedad se usa para obtener o establecer el color de primer plano del control.
Altura Esta propiedad se utiliza para obtener o establecer la altura del control.
Ubicación Esta propiedad se usa para obtener o establecer las coordenadas de la esquina superior izquierda del control MaskedTextBox en relación con la esquina superior izquierda de su formulario.
Nombre Esta propiedad se utiliza para obtener o establecer el nombre del control.
Tabulación Esta propiedad se usa para obtener o establecer un valor que muestre si el usuario puede presionar la tecla TAB para proporcionar el foco a NumericUpDown.
Tamaño Esta propiedad se usa para obtener o establecer la altura y el ancho del control.
Texto Esta propiedad se usa para obtener o establecer el texto que se mostrará en el control RichTextBox.
Visible Esta propiedad se usa para obtener o establecer un valor que indica si se muestran el control y todos sus controles secundarios.
Ancho Esta propiedad se usa para obtener o establecer el ancho del control.
multilínea Esta propiedad se usa para obtener o establecer un valor que indica si se trata de un control MaskedTextBox de varias líneas.
Texto alineado Esta propiedad se usa para obtener o establecer cómo se alinea el texto en un control de cuadro de texto enmascarado.
Formato de máscara de texto Esta propiedad se usa para obtener o establecer un valor que determina si los literales y los caracteres de solicitud se incluyen en la string formateada.
TextoSeleccionado Esta propiedad se usa para obtener o establecer la selección actual en el control MaskedTextBox.
PromptChar Esta propiedad se usa para obtener o establecer el carácter que se usa para representar la ausencia de entrada del usuario en MaskedTextBox.
Solo lectura Esta propiedad se usa para obtener o establecer un valor que indica si el texto del cuadro de texto es de solo lectura.
Longitud máxima Esta propiedad se usa para obtener o establecer el número máximo de caracteres que el usuario puede escribir o pegar en el control de cuadro de texto. MaskedTextBox no admite esta propiedad.
Líneas Esta propiedad se usa para obtener o establecer las líneas de texto en configuraciones de varias líneas. MaskedTextBox no admite esta propiedad.

Publicación traducida automáticamente

Artículo escrito por ankita_saini y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *