MaskedTextBox.Mask Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Obtiene o establece la máscara de entrada que se utilizará en tiempo de ejecución.

public:
 property System::String ^ Mask { System::String ^ get(); void set(System::String ^ value); };
public string Mask { get; set; }
member this.Mask : string with get, set
Public Property Mask As String

Valor de propiedad

String

String que representa la máscara actual. El valor predeterminado es la cadena vacía que permite cualquier entrada.

Excepciones

ArgumentException

La cadena suministrada a la propiedad Mask no es una máscara válida. Entre las máscaras no válidas se incluyen las máscaras que contienen caracteres no imprimibles.

Comentarios

Mask es la propiedad predeterminada de la MaskedTextBox clase .

Mask debe ser una cadena compuesta por uno o varios de los elementos de enmascaramiento, como se muestra en la tabla siguiente. El lenguaje de enmascaramiento utilizado por MaskedTextBox se define mediante su asociado MaskedTextProvider. El proveedor estándar especifica un lenguaje de enmascaramiento basado en el que usa el control Edición enmascarada en Visual Basic 6.0 y debe ser muy familiar para los usuarios que migran desde esa plataforma.

Elemento Masking Descripción
0 Dígito, obligatorio. Este elemento aceptará cualquier dígito único entre 0 y 9.
9 Dígito o espacio, opcional.
# Dígito o espacio, opcional. Si esta posición está en blanco en la máscara, se representará como un espacio en la Text propiedad . Se permiten signos más (+) y menos (-).
L Carta, requerida. Restringe la entrada a las letras ASCII a-z y A-Z. Este elemento mask es equivalente a [a-zA-Z] en expresiones regulares.
? Carta, opcional. Restringe la entrada a las letras ASCII a-z y A-Z. Este elemento mask es equivalente a [a-zA-Z]? en expresiones regulares.
& Carácter, obligatorio. Si la AsciiOnly propiedad se establece en true, este elemento se comporta como el elemento "L".
C Carácter, opcional. Cualquier carácter que no sea de control. Si la AsciiOnly propiedad se establece trueen , este elemento se comporta como el elemento "?" .
A Alfanumérico, obligatorio. Si la AsciiOnly propiedad se establece trueen , los únicos caracteres que aceptarán son las letras ASCII a-z y A-Z. Este elemento mask se comporta como el elemento "a".
a Alfanumérico, opcional. Si la AsciiOnly propiedad se establece trueen , los únicos caracteres que aceptarán son las letras ASCII a-z y A-Z. Este elemento mask se comporta como el elemento "A".
. Marcador de posición decimal. El carácter de presentación real usado será el símbolo decimal adecuado para el proveedor de formato, determinado por la propiedad del FormatProvider control.
, Marcador de posición de miles. El carácter de presentación real usado será el marcador de posición miles adecuado para el proveedor de formato, determinado por la propiedad del FormatProvider control.
: Separador de líneas. El carácter de presentación real usado será el símbolo de hora adecuado para el proveedor de formato, determinado por la propiedad del FormatProvider control.
/ Separador de fecha. El carácter de presentación real usado será el símbolo de fecha adecuado para el proveedor de formato, determinado por la propiedad del FormatProvider control.
$ Símbolo de moneda. El carácter real que se muestra será el símbolo de moneda adecuado para el proveedor de formato, determinado por la propiedad del FormatProvider control.
< Desplazá hacia abajo. Convierte todos los caracteres que siguen a minúsculas.
> Desplazá hacia arriba. Convierte todos los caracteres de una cadena a mayúsculas.
| Deshabilite un desplazamiento anterior hacia arriba o hacia abajo.
\ Escapar. Aplica un carácter de mark a cualquier carácter, convirtiéndolo en un literal. "\\" es la secuencia de escape de una barra diagonal inversa.
Todos los demás caracteres Literales. Todos los elementos que no son máscaras aparecerán como sí mismos dentro de MaskedTextBox. Los literales siempre ocupan una posición estática en la máscara en tiempo de ejecución y el usuario no puede moverlos ni eliminarlos.

Si cambia una máscara cuando MaskedTextBox ya contiene la entrada del usuario filtrada por una máscara anterior, MaskedTextBox intentará migrar esa entrada a la nueva definición de máscara. Si se produce un error, borrará la entrada existente. La asignación de una cadena de longitud cero como máscara conservará los datos existentes en el control. Cuando se usa con una máscara de longitud cero, MaskedTextBox se comporta como un control de una sola línea TextBox .

Los símbolos decimales (.), thousandths (,), time (:), date (/) y currency ($) tienen como valor predeterminado mostrar esos símbolos según se define en la referencia cultural de la aplicación. Puede obligarlos a mostrar símbolos para otra referencia cultural mediante la FormatProvider propiedad.

La propiedad controla InsertKeyMode la inserción de caracteres en la máscara en tiempo de ejecución. Los usuarios pueden navegar por la máscara mediante las teclas de dirección izquierda y derecha o el cursor del mouse, y pueden omitir las posiciones opcionales en la máscara escribiendo un espacio.

Importante

MaskedTextBox admite todos los caracteres Unicode, excepto los suplentes y los caracteres combinados verticalmente.

En la tabla siguiente se muestran máscaras de ejemplo.

Máscara Comportamiento
00/00/0000 Una fecha (día, mes numérico, año) en formato de fecha internacional. El carácter "/" es un separador de fecha lógico y aparecerá al usuario como separador de fecha adecuado para la referencia cultural actual de la aplicación.
00->L<LL-0000 Fecha (día, abreviatura del mes y año) en Estados Unidos formato en el que se muestra la abreviatura de tres letras del mes con una letra mayúscula inicial seguida de dos letras minúsculas.
(999)-000-0000 Estados Unidos número de teléfono, código de área opcional. Si los usuarios no quieren escribir los caracteres opcionales, pueden escribir espacios o colocar el puntero del mouse directamente en la posición de la máscara representada por el primer 0.
$999,999.00 Valor de moneda en el intervalo de 0 a 999999. Los caracteres de moneda, milésima y decimal se reemplazarán en tiempo de ejecución por sus equivalentes específicos de la referencia cultural.

Se aplica a

Consulte también