Partager via

MaskedTextBox.Mask Propriété

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
MaskedTextBox.cs
Source:
MaskedTextBox.cs
Source:
MaskedTextBox.cs
Source:
MaskedTextBox.cs
Source:
MaskedTextBox.cs

Obtient ou définit le masque d’entrée à 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

Représentant String le masque actuel. La valeur par défaut est la chaîne vide qui autorise n’importe quelle entrée.

Exceptions

ArgumentException

La chaîne fournie à la Mask propriété 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. Le langage de masquage utilisé par MaskedTextBox est défini par son associé MaskedTextProvider. Le fournisseur standard spécifie un langage de masquage basé sur celui utilisé par le contrôle Masked Edit dans Visual Basic 6.0 et doit être très familier pour les utilisateurs qui migrent à partir de cette plateforme.

Élément de masquage Description
0 Chiffre, obligatoire. Cet élément accepte un chiffre unique compris entre 0 et 9.
9 Chiffre ou espace, facultatif.
# Chiffre ou espace, facultatif. Si cette position est vide dans le masque, elle est rendue sous forme d’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 équivaut à [a-zA-Z] dans les expressions régulières.
? Lettre, facultative. Limite l’entrée aux lettres ASCII a-z et A-Z. Cet élément de masque équivaut à [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 AsciiOnly propriété est définie truesur , cet élément se comporte comme l’élément « ? ».
A Alphanumérique, obligatoire. Si la AsciiOnly propriété est définie truesur , les seuls caractères qu’il accepte sont les lettres ASCII a-z et A-Z. Cet élément masque se comporte comme l’élément « a ».
a Alphanumérique, facultatif. Si la AsciiOnly propriété est définie truesur , les seuls caractères qu’il accepte sont les lettres ASCII a-z et A-Z. Cet élément 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.
, Des milliers d’espaces réservés. Le caractère d’affichage réel utilisé sera l’espace réservé des milliers approprié au 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é est le symbole d’heure approprié au 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é au 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.
< Descendez vers le bas. Convertit tous les caractères qui suivent en minuscules.
> Se déplacer vers le haut. Convertit tous les caractères qui suivent en majuscules.
| Désactivez un décalage précédent vers le haut ou le bas.
\ Échapper. Échappe un caractère de masque et le convertit en 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 apparaissent comme 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 lorsqu’il MaskedTextBox contient déjà une entrée utilisateur filtrée par un masque précédent, MaskedTextBox tentez de migrer cette entrée dans la nouvelle définition de masque. En cas d’échec, elle efface l’entrée existante. L’affectation d’une chaîne de longueur nulle en tant que masque conserve 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 ($) s'affichent par défaut 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 FormatProvider propriété.

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 parcourir le masque à l’aide des touches de direction 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 substitutions et des caractères combinés verticalement.

Le tableau suivant présente des exemples de masques.

Mask Comportement
00/00/0000 Date (jour, mois numérique, année) au format de date international. 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 de trois lettres est affichée avec une lettre majuscule initiale suivie de deux lettres minuscules.
(999)-000-0000 Numéro de téléphone des États-Unis, code de zone 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 du masque représenté par les 0 premiers.
$999,999.00 Valeur monétaire comprise entre 0 et 999999. La devise, le millième et les caractères décimaux seront remplacés au moment de l’exécution par leurs équivalents propres à la culture.

S’applique à

Voir aussi