MaskedTextBox.Mask Propiedad

Definición

Obtiene o establece la máscara de entrada que se utilizará en tiempo de ejecución.Gets or sets the input mask to use at run time.

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 que representa la máscara actual.A String representing the current mask. El valor predeterminado es la cadena vacía que permite cualquier entrada.The default value is the empty string which allows any input.

Excepciones

La cadena suministrada a la propiedad Mask no es una máscara válida.The string supplied to the Mask property is not a valid mask. Entre las máscaras no válidas se incluyen las máscaras que contienen caracteres no imprimibles.Invalid masks include masks containing non-printable characters.

Comentarios

Mask es la propiedad predeterminada de la clase MaskedTextBox.Mask is the default property for the MaskedTextBox class.

Mask debe ser una cadena formada por uno o varios de los elementos de enmascaramiento, como se muestra en la tabla siguiente.Mask must be a string composed of one or more of the masking elements, as shown in the following table. El lenguaje de enmascaramiento que utiliza MaskedTextBox se define mediante su MaskedTextProviderasociada.The masking language used by MaskedTextBox is defined by its associated MaskedTextProvider. El proveedor estándar especifica un lenguaje de enmascaramiento basado en el que usa el control de edición con máscara en Visual Basic 6,0 y debe ser muy familiar a los usuarios que migran desde esa plataforma.The standard provider specifies a masking language based upon the one used by the Masked Edit control in Visual Basic 6.0, and should be very familiar to users migrating from that platform.

Enmascaramiento (elemento)Masking element DescripciónDescription
00 Digit, required.Digit, required. Este elemento aceptará cualquier dígito único entre 0 y 9.This element will accept any single digit between 0 and 9.
99 Dígito o espacio, opcional.Digit or space, optional.
# Dígito o espacio, opcional.Digit or space, optional. Si esta posición está en blanco en la máscara, se representará como un espacio en la propiedad Text.If this position is blank in the mask, it will be rendered as a space in the Text property. Se permiten signos más (+) y menos (-).Plus (+) and minus (-) signs are allowed.
LL Letter, required.Letter, required. Restringe la entrada a las letras ASCII a-z y A-Z.Restricts input to the ASCII letters a-z and A-Z. Este elemento de máscara es equivalente a [a-zA-Z] en expresiones regulares.This mask element is equivalent to [a-zA-Z] in regular expressions.
?? Letter, opcional.Letter, optional. Restringe la entrada a las letras ASCII a-z y A-Z.Restricts input to the ASCII letters a-z and A-Z. Este elemento de máscara es equivalente a [a-zA-Z]?This mask element is equivalent to [a-zA-Z]? en expresiones regulares.in regular expressions.
& Carácter requerido.Character, required. Si la propiedad AsciiOnly está establecida en true, este elemento se comporta como el elemento "L".If the AsciiOnly property is set to true, this element behaves like the "L" element.
CC Carácter, opcional.Character, optional. Cualquier carácter que no sea de control.Any non-control character. Si la propiedad AsciiOnly está establecida en true, este elemento se comporta como el elemento "?".If the AsciiOnly property is set to true, this element behaves like the "?" element.
UnA Alfanumérica, requerida.Alphanumeric, required. Si la propiedad AsciiOnly está establecida en true, los únicos caracteres que aceptarán son las letras ASCII a-z y A-Z.If the AsciiOnly property is set to true, the only characters it will accept are the ASCII letters a-z and A-Z. Este elemento de máscara se comporta como el elemento "a".This mask element behaves like the "a" element.
aa Alfanumérico, opcional.Alphanumeric, optional. Si la propiedad AsciiOnly está establecida en true, los únicos caracteres que aceptarán son las letras ASCII a-z y A-Z.If the AsciiOnly property is set to true, the only characters it will accept are the ASCII letters a-z and A-Z. Este elemento de máscara se comporta como el elemento "A".This mask element behaves like the "A" element.
.. Marcador de posición de decimales.Decimal placeholder. El carácter de presentación real utilizado será el símbolo decimal apropiado para el proveedor de formato, determinado por la propiedad FormatProvider del control.The actual display character used will be the decimal symbol appropriate to the format provider, as determined by the control's FormatProvider property.
., Marcador de posición de miles.Thousands placeholder. El carácter de presentación real utilizado será el marcador de posición de miles apropiado para el proveedor de formato, determinado por la propiedad FormatProvider del control.The actual display character used will be the thousands placeholder appropriate to the format provider, as determined by the control's FormatProvider property.
:: Separador de hora.Time separator. El carácter de presentación real utilizado será el símbolo de hora apropiado para el proveedor de formato, determinado por la propiedad FormatProvider del control.The actual display character used will be the time symbol appropriate to the format provider, as determined by the control's FormatProvider property.
/ Separador de fecha.Date separator. El carácter de presentación real utilizado será el símbolo de fecha apropiado para el proveedor de formato, determinado por la propiedad FormatProvider del control.The actual display character used will be the date symbol appropriate to the format provider, as determined by the control's FormatProvider property.
$ Símbolo de moneda.Currency symbol. El carácter real que se muestra será el símbolo de moneda apropiado para el proveedor de formato, determinado por la propiedad FormatProvider del control.The actual character displayed will be the currency symbol appropriate to the format provider, as determined by the control's FormatProvider property.
< Desplazarse hacia abajo.Shift down. Convierte todos los caracteres que siguen a minúsculas.Converts all characters that follow to lowercase.
> Desplazar hacia arriba.Shift up. Convierte todos los caracteres que siguen a mayúsculas.Converts all characters that follow to uppercase.
|| Deshabilitar un desplazamiento anterior o desplazarse hacia abajo.Disable a previous shift up or shift down.
\\ Salida.Escape. Escapa un carácter de máscara, convirtiéndolo en un literal.Escapes a mask character, turning it into a literal. "\\" es la secuencia de escape para una barra diagonal inversa."\\" is the escape sequence for a backslash.
Todos los demás caracteresAll other characters Literales.Literals. Todos los elementos que no sean de máscara aparecerán como ellos mismos en MaskedTextBox.All non-mask elements will appear as themselves within 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.Literals always occupy a static position in the mask at run time, and cannot be moved or deleted by the user.

Si cambia una máscara cuando MaskedTextBox ya contiene datos proporcionados por el usuario filtrados por una máscara anterior, MaskedTextBox intentará migrar esa entrada a la nueva definición de máscara.If you change a mask when MaskedTextBox already contains user input filtered by a previous mask, MaskedTextBox will attempt to migrate that input into the new mask definition. Si se produce un error, borrará la entrada existente.If it fails, it will clear the existing input. Si se asigna una cadena de longitud cero como máscara, se conservarán los datos existentes en el control.Assigning a zero-length string as the mask will preserve any existing data in the control. Cuando se usa con una máscara de longitud cero, MaskedTextBox se comporta como un control de TextBox de una sola línea.When used with a zero-length mask, MaskedTextBox behaves like a single-line TextBox control.

Los símbolos decimales (.), milésimas (,), Time (:), Date (/) y Currency ($) tienen como valor predeterminado los símbolos definidos por la referencia cultural de la aplicación.The decimal (.), thousandths (,), time (:), date (/), and currency ($) symbols default to displaying those symbols as defined by the application's culture. Puede obligarles a mostrar símbolos para otra referencia cultural mediante el FormatProvider propiedad.You can force them to display symbols for another culture by using the FormatProvider property.

La inserción de caracteres en la máscara en tiempo de ejecución se controla mediante la propiedad InsertKeyMode.Character insertion into the mask at run time is controlled by the InsertKeyMode property. 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 de la máscara escribiendo un espacio.Users can navigate through the mask by using the left and right arrow keys or the mouse cursor, and can skip optional positions in the mask by entering a space.

Importante

MaskedTextBox admite todos los caracteres Unicode salvo los suplentes y los caracteres combinados verticalmente.MaskedTextBox supports all Unicode characters except for surrogates and vertically combined characters.

En la tabla siguiente se muestran máscaras de ejemplo.The following table shows example masks.

MáscaraMask ComportamientoBehavior
00/00/0000 Una fecha (día, mes numérico, año) en formato de fecha internacional.A date (day, numeric month, year) in international date format. El carácter "/" es un separador de fecha lógica y se mostrará al usuario como el separador de fecha apropiado para la referencia cultural actual de la aplicación.The "/" character is a logical date separator, and will appear to the user as the date separator appropriate to the application's current culture.
00->L<LL-0000 Una fecha (día, abreviatura del mes y año) en Estados Unidos formato en el que se muestra la abreviatura del mes de tres letras con una letra mayúscula inicial seguida de dos letras en minúsculas.A date (day, month abbreviation, and year) in United States format in which the three-letter month abbreviation is displayed with an initial uppercase letter followed by two lowercase letters.
(999)-000-0000 Estados Unidos número de teléfono, código de área opcional.United States phone number, area code optional. Si los usuarios no desean 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.If users do not want to enter the optional characters, they can either enter spaces or place the mouse pointer directly at the position in the mask represented by the first 0.
$999,999.00 Un valor de moneda en el intervalo de 0 a 999999.A currency value in the range of 0 to 999999. Los caracteres Currency, milésima y decimal se reemplazarán en tiempo de ejecución por sus equivalentes específicos de la referencia cultural.The currency, thousandth, and decimal characters will be replaced at run time with their culture-specific equivalents.

Se aplica a

Consulte también: