MaskedTextBox.Mask Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtient ou définit le masque de saisie à utiliser au moment de l'exécution.

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

Valeur de propriété

String

String représentant le masque actuel. La valeur par défaut est la chaîne vide qui autorise toute entrée.

Exceptions

ArgumentException

La chaîne fournie à la propriété Mask n'est pas un masque valide. Les masques non valides incluent des masques contenant des caractères non imprimables.

Remarques

Mask est la propriété par défaut de la MaskedTextBox classe .

Mask doit être une chaîne composée d’un ou plusieurs éléments de masquage, comme indiqué dans le tableau suivant. La langue de masquage utilisée par MaskedTextBox est définie par son associé MaskedTextProvider. Le fournisseur standard spécifie une langue de masquage basée sur celle utilisée par le contrôle d’édition masquée dans Visual Basic 6.0, et doit être très familière aux utilisateurs qui migrent à partir de cette plateforme.

Élément de masquage Description
0 Chiffre, obligatoire. Cet élément accepte n’importe quel chiffre compris entre 0 et 9.
9 Chiffre ou espace, facultatif.
# Chiffre ou espace, facultatif. Si cette position est vide dans le masque, elle est affichée sous la forme d’un espace dans la Text propriété . Les signes plus (+) et moins (-) sont autorisés.
L Lettre, obligatoire. Limite l’entrée aux lettres ASCII a-z et A-Z. Cet élément mask est équivalent à [a-zA-Z] dans les expressions régulières.
? Lettre, facultatif. Limite l’entrée aux lettres ASCII a-z et A-Z. Cet élément de masque est équivalent à [a-zA-Z] ? dans les expressions régulières.
& Caractère, obligatoire. Si la propriété a la AsciiOnly valeur true, cet élément se comporte comme l’élément « L ».
C Caractère, facultatif. Tout caractère non-contrôle. Si la propriété a la AsciiOnlytruevaleur , cet élément se comporte comme l’élément « ? ».
A Alphanumérique, obligatoire. Si la AsciiOnly propriété a la valeur true, les seuls caractères qu’elle accepte sont les lettres ASCII a-z et A-Z. Cet élément de masque se comporte comme l’élément « a ».
a Alphanumérique, facultatif. Si la AsciiOnly propriété a la valeur true, les seuls caractères qu’elle accepte sont les lettres ASCII a-z et A-Z. Cet élément de masque se comporte comme l’élément « A ».
. Espace réservé de décimale. Le caractère d’affichage réel utilisé sera le symbole décimal approprié au fournisseur de format, tel que déterminé par la propriété du FormatProvider contrôle.
, Espace réservé des milliers. Le caractère d’affichage réel utilisé sera l’espace réservé de milliers approprié pour le fournisseur de format, tel que déterminé par la propriété du FormatProvider contrôle.
: Séparateur d’heure. Le caractère d’affichage réel utilisé sera le symbole d’heure approprié pour le fournisseur de format, tel que déterminé par la propriété du FormatProvider contrôle.
/ Séparateur de date. Le caractère d’affichage réel utilisé sera le symbole de date approprié pour le fournisseur de format, tel que déterminé par la propriété du FormatProvider contrôle.
$ Symbole monétaire. Le caractère réel affiché sera le symbole monétaire approprié au fournisseur de format, tel que déterminé par la propriété du FormatProvider contrôle.
< Décaler vers le bas. Convertit tous les caractères qui suivent en minuscules.
> Déplacer vers le haut. Convertit tous les caractères qui suivent en majuscules.
| Désactivez un shift précédent vers le haut ou vers le bas.
\ Échapper. Place n’importe quel caractère dans une séquence d’échappement pour en faire un littéral. « \\ » est la séquence d’échappement d’une barre oblique inverse.
Tous les autres caractères littéraux. Tous les éléments non-masque apparaîtront eux-mêmes dans MaskedTextBox. Les littéraux occupent toujours une position statique dans le masque au moment de l’exécution et ne peuvent pas être déplacés ou supprimés par l’utilisateur.

Si vous modifiez un masque alors que MaskedTextBox contient déjà une entrée utilisateur filtrée par un masque précédent, MaskedTextBox tente de migrer cette entrée vers la nouvelle définition de masque. En cas d’échec, l’entrée existante est effacée. L’affectation d’une chaîne de longueur nulle en tant que masque permet de conserver toutes les données existantes dans le contrôle. Lorsqu’il est utilisé avec un masque de longueur nulle, MaskedTextBox se comporte comme un contrôle à ligne TextBox unique.

Les symboles décimaux (.), millièmes (,), heure (:), date (/) et devise ($) affichent par défaut ces symboles tels que définis par la culture de l’application. Vous pouvez les forcer à afficher des symboles pour une autre culture à l’aide de la propriété FormatProvider.

L’insertion de caractères dans le masque au moment de l’exécution est contrôlée par la InsertKeyMode propriété . Les utilisateurs peuvent naviguer dans le masque à l’aide des flèches gauche et droite ou du curseur de la souris, et peuvent ignorer les positions facultatives dans le masque en entrant un espace.

Important

MaskedTextBox prend en charge tous les caractères Unicode à l’exception des substituts et des caractères combinés verticalement.

Le tableau suivant présente des exemples de masques.

Mask Comportement
00/00/0000 Une date (jour, mois numérique, année) au format international de date. Le caractère « / » est un séparateur de date logique et apparaît à l’utilisateur comme séparateur de date approprié à la culture actuelle de l’application.
00->L<LL-0000 Date (jour, abréviation de mois et année) au format États-Unis dans lequel l’abréviation de mois à trois lettres est affichée avec une lettre majuscule initiale suivie de deux lettres minuscules.
(999)-000-0000 Numéro de téléphone aux États-Unis, indicatif régional facultatif. Si les utilisateurs ne souhaitent pas entrer les caractères facultatifs, ils peuvent entrer des espaces ou placer le pointeur de la souris directement à la position dans le masque représenté par le premier 0.
$999,999.00 Valeur monétaire comprise entre 0 et 999999. Les caractères monétaire, millième et décimal seront remplacés au moment de l’exécution par leurs équivalents spécifiques à la culture.

S’applique à

Voir aussi