MaskedTextBox.Mask Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает маску ввода для использования во время выполнения.

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

Значение свойства

String

Строка String, представляющая текущую маску. По умолчанию используется пустая строка, которая разрешает ввод любых символов.

Исключения

ArgumentException

Свойству Mask передана строка, недопустимая в качестве маски. К недопустимым маскам относятся те, которые содержат непечатаемые символы.

Комментарии

Mask — это свойство по умолчанию для MaskedTextBox класса .

Mask должен быть строкой, состоящей из одного или нескольких элементов маскирования, как показано в следующей таблице. Язык маскирования, используемый , MaskedTextBox определяется связанным с MaskedTextProviderним . Стандартный поставщик определяет язык маскирования на основе языка, используемого элементом управления "Маскированная правка" в Visual Basic 6.0, и должен быть очень знаком пользователям, которые переходят с этой платформы.

Элемент маскирования	Описание
0	Цифра, обязательный. Этот элемент принимает любую одну цифру в диапазоне от 0 до 9.
9	Цифра или пробел, необязательно.
#	Цифра или пробел, необязательно. Если эта позиция в маске пуста, она будет отображаться в качестве пробела в свойстве Text . Допускаются знаки "плюс" (+) и "минус" (-).
L	Обязательное письмо. Ограничивает входные данные буквами ASCII a–z и A–Z. Этот элемент mask эквивалентен [a-zA-Z] в регулярных выражениях.
?	Буква, необязательно. Ограничивает входные данные буквами ASCII a–z и A–Z. Этот элемент mask эквивалентен [a-zA-Z]? в регулярных выражениях.
&	Символ, обязательный. Если свойству AsciiOnly присвоено значение true, этот элемент ведет себя как элемент "L".
C	Символ, необязательный. Любой неконтрольный символ. Если свойству AsciiOnly присвоено значение true, этот элемент ведет себя как элемент "?".
Объект	Буквенно-цифровой, обязательный. Если свойству AsciiOnly присвоено значение true, единственными символами, которые оно будет принимать, являются буквы ASCII a–z и A–Z. Этот элемент mask ведет себя как элемент "a".
а	Буквенно-цифровой, необязательный. Если свойству AsciiOnly присвоено значение true, единственными символами, которые оно будет принимать, являются буквы ASCII a–z и A–Z. Этот элемент mask ведет себя как элемент "A".
.	Заполнитель десятичных чисел. Фактически используемый отображаемый символ будет десятичным символом, соответствующим поставщику формата, который определяется свойством элемента управления FormatProvider .
,	Заполнитель "Тысячи". Фактически используемый символ отображения будет заполнителем тысяч, соответствующим поставщику формата, как определено свойством элемента управления FormatProvider .
:	Разделитель времени. Фактически используемый символ отображения будет символом времени, соответствующим поставщику форматирования, который определяется свойством элемента управления FormatProvider .
/	Разделитель даты. Фактически используемый символ отображения будет символом даты, соответствующим поставщику формата, который определяется свойством элемента управления FormatProvider .
$	Символ валюты. Фактически отображаемый символ будет символом валюты, соответствующим поставщику формата, как определено свойством элемента управления FormatProvider .
<	Смещение вниз. Преобразует все следующие символы в нижний регистр.
>	Сдвиг вверх. Преобразует все следующие символы в верхний регистр.
|	Отключите предыдущее смещение вверх или вниз.
\	Побег. Экранирует символ маски, превращая его в литерал. "\\" — это escape-последовательность для обратной косой черты.
Все остальные символы	Литералы. Все немасковые элементы будут отображаться как сами в MaskedTextBox. Литералы всегда занимают статическое положение в маске во время выполнения и не могут быть перемещены или удалены пользователем.

Если вы изменяете маску, если MaskedTextBox она уже содержит входные данные пользователя, отфильтрованные по предыдущей маске, MaskedTextBox попытается перенести эти входные данные в новое определение маски. В случае сбоя существующие входные данные будут очищены. При назначении строки нулевой длины в качестве маски все существующие данные в элементе управления сохраняются. При использовании с маской MaskedTextBox нулевой длины работает как однострочный TextBox элемент управления.

Десятичные (.), тысячные (,), время (:), дата (/) и валюта ($) по умолчанию отображают эти символы в соответствии с языком и региональными параметрами приложения. Вы можете принудительно отобразить символы для другого языка и региональных параметров с помощью FormatProvider свойства .

Вставка символов в маску во время выполнения управляется свойством InsertKeyMode . Пользователи могут перемещаться по маске с помощью клавиш со стрелками влево и вправо или курсора мыши, а также пропускать необязательные позиции в маске, вводя пробел.

Важно!

MaskedTextBox поддерживает все символы Юникода, кроме суррогатов и вертикально объединенных символов.

В следующей таблице показаны примеры масок.

Mask	Поведение
00/00/0000	Дата (день, числовой месяц, год) в международном формате даты. Символ "/" является логическим разделителем даты и будет отображаться пользователю как разделитель дат, соответствующий текущему языку и региональным параметрам приложения.
00->L<LL-0000	Дата (день, сокращение месяца и год) в США формате, в котором трехбуквенное сокращение месяца отображается с начальной прописной буквой, за которой следуют две строчные буквы.
(999)-000-0000	США номер телефона, код города необязательный. Если пользователи не хотят вводить необязательные символы, они могут либо ввести пробелы, либо поместить указатель мыши непосредственно в положение в маске, представленной первым 0.
$999,999.00	Значение валюты в диапазоне от 0 до 999999. Денежные, тысячные и десятичные символы будут заменены во время выполнения их эквивалентами для конкретного языка и региональных параметров.

См. также раздел

• Text
• MaskFull
• MaskCompleted
• MaskChanged
• MaskedTextProvider