MaskedTextBox.Mask Свойство

Определение

Получает или задает маску ввода для использования во время выполнения.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

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

Строка String, представляющая текущую маску.A String representing the current mask. По умолчанию используется пустая строка, которая разрешает ввод любых символов.The default value is the empty string which allows any input.

Исключения

Свойству Mask передана строка, недопустимая в качестве маски.The string supplied to the Mask property is not a valid mask. К недопустимым маскам относятся те, которые содержат непечатаемые символы.Invalid masks include masks containing non-printable characters.

Комментарии

Maskсвойство по умолчанию для MaskedTextBox класса.Mask is the default property for the MaskedTextBox class.

Maskдолжен быть строкой, состоящей из одного или нескольких элементов маскировки, как показано в следующей таблице.Mask must be a string composed of one or more of the masking elements, as shown in the following table. Язык маскирования, используемый, MaskedTextBox определяется связанным MaskedTextProviderс ним.The masking language used by MaskedTextBox is defined by its associated MaskedTextProvider. Стандартный поставщик определяет язык маскирования на основе того, который используется маскированным элементом управления "поле ввода" в Visual Basic 6,0 и должен быть очень знаком пользователям, переносящим эту платформу.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.

Маскирование элементаMasking element ОписаниеDescription
00 Цифра, обязательное.Digit, required. Этот элемент будет принимать любую цифру от 0 до 9.This element will accept any single digit between 0 and 9.
99 Цифра или пробел, необязательно.Digit or space, optional.
# Цифра или пробел, необязательно.Digit or space, optional. Если эта ячейка в маске пуста, она будет отображена в качестве пробела Text в свойстве.If this position is blank in the mask, it will be rendered as a space in the Text property. Разрешены знаки плюс (+) и минус (-).Plus (+) and minus (-) signs are allowed.
LL Буква, обязательная.Letter, required. Ограничивают ввод буквами ASCII a-z и A-Z.Restricts input to the ASCII letters a-z and A-Z. Этот элемент маски эквивалентен [a-zA-Z] в регулярных выражениях.This mask element is equivalent to [a-zA-Z] in regular expressions.
?? Letter, необязательно.Letter, optional. Ограничивают ввод буквами ASCII a-z и A-Z.Restricts input to the ASCII letters a-z and A-Z. Этот элемент маски эквивалентен [a-zA-Z]?This mask element is equivalent to [a-zA-Z]? в регулярных выражениях.in regular expressions.
& Символ, обязательный.Character, required. AsciiOnly Если свойство имеет значение true, этот элемент ведет себя как элемент «L».If the AsciiOnly property is set to true, this element behaves like the "L" element.
ВC Символ, необязательный.Character, optional. Любой символ, не являющийся управляющей.Any non-control character. Если свойство имеет trueзначение, этот элемент ведет себя как элемент "?". AsciiOnlyIf the AsciiOnly property is set to true, this element behaves like the "?" element.
АA Буквенно-цифровой, обязательный.Alphanumeric, required. Если свойство имеет trueзначение, единственные символы, которые он будет принимать, — это буквы ASCII a – z и a – z. AsciiOnlyIf the AsciiOnly property is set to true, the only characters it will accept are the ASCII letters a-z and A-Z. Этот элемент маски ведет себя как элемент "a".This mask element behaves like the "a" element.
примерa Буквенно-цифровой, необязательный.Alphanumeric, optional. Если свойство имеет trueзначение, единственные символы, которые он будет принимать, — это буквы ASCII a – z и a – z. AsciiOnlyIf the AsciiOnly property is set to true, the only characters it will accept are the ASCII letters a-z and A-Z. Этот элемент маски ведет себя как элемент "A".This mask element behaves like the "A" element.
.. Десятичный заполнитель.Decimal placeholder. Фактически используемый отображаемый символ будет являться десятичным символом, соответствующим поставщику формата, как определено FormatProvider свойством элемента управления.The actual display character used will be the decimal symbol appropriate to the format provider, as determined by the control's FormatProvider property.
,, Заполнитель тысяч.Thousands placeholder. Фактически используемый отображаемый символ будет заполнительом тысяч, соответствующим поставщику формата, как определено FormatProvider свойством элемента управления.The actual display character used will be the thousands placeholder appropriate to the format provider, as determined by the control's FormatProvider property.
:: Разделитель времени.Time separator. Фактически используемым отображаемым символом будет символ времени, соответствующий поставщику формата, как определено FormatProvider свойством элемента управления.The actual display character used will be the time symbol appropriate to the format provider, as determined by the control's FormatProvider property.
/ Разделитель компонентов даты.Date separator. Фактический отображаемый символ будет использоваться в качестве символа даты, соответствующего поставщику формата, как определено FormatProvider свойством элемента управления.The actual display character used will be the date symbol appropriate to the format provider, as determined by the control's FormatProvider property.
$ Символ валюты.Currency symbol. Фактически отображаемый символ будет символом валюты, соответствующим поставщику формата, как определено FormatProvider свойством элемента управления.The actual character displayed will be the currency symbol appropriate to the format provider, as determined by the control's FormatProvider property.
< Сдвинуть вниз.Shift down. Преобразует все символы, указанные после, в нижний регистр.Converts all characters that follow to lowercase.
> Сдвинуть вверх.Shift up. Преобразует все символы, следующие за прописной буквой.Converts all characters that follow to uppercase.
|| Отключить предыдущую смену вверх или Сдвинуть вниз.Disable a previous shift up or shift down.
\\ Выполняет.Escape. Обходит символ маски, преобразуя его в литерал.Escapes a mask character, turning it into a literal. \"\" — escape-последовательность для обратной косой черты."\\" is the escape sequence for a backslash.
Все остальные символыAll other characters Литералы.Literals. Все элементы, не являющиеся маской, будут отображаться MaskedTextBoxв.All non-mask elements will appear as themselves within MaskedTextBox. Литералы всегда занимают статическую точку в маске во время выполнения и не могут быть перемещены или удалены пользователем.Literals always occupy a static position in the mask at run time, and cannot be moved or deleted by the user.

Если изменить маску, если MaskedTextBox она уже содержит входные данные пользователя, отфильтрованные MaskedTextBox по предыдущей маске, попытается перенести эти входные данные в новое определение маски.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. В случае сбоя он очистит существующие входные данные.If it fails, it will clear the existing input. Назначение строки нулевой длины в качестве маски сохранит все существующие данные в элементе управления.Assigning a zero-length string as the mask will preserve any existing data in the control. При использовании с маской MaskedTextBox нулевой длины ведет себя как однострочный TextBox элемент управления.When used with a zero-length mask, MaskedTextBox behaves like a single-line TextBox control.

Символы Decimal (.), доли (,), Time (:), Date (/) и Currency ($) по умолчанию отображают эти символы в соответствии с языком и региональными параметрами приложения.The decimal (.), thousandths (,), time (:), date (/), and currency ($) symbols default to displaying those symbols as defined by the application's culture. Можно принудительно отображать символы для другого языка и региональных параметров с помощью FormatProvider свойства.You can force them to display symbols for another culture by using the FormatProvider property.

Вставка символа в маску во время выполнения управляется InsertKeyMode свойством.Character insertion into the mask at run time is controlled by the InsertKeyMode property. Пользователи могут перемещаться по маске с помощью клавиш со стрелками влево и вправо или курсора мыши, а также пропускать необязательные позиции в маске, вводя пробел.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.

Важно!

MaskedTextBoxподдерживает все символы Юникода, кроме суррогатов и вертикально Объединенных символов.MaskedTextBox supports all Unicode characters except for surrogates and vertically combined characters.

В следующей таблице показаны примеры масок.The following table shows example masks.

МаскаMask ПоведениеBehavior
00/00/0000 Дата (день, числовой месяц, год) в международном формате даты.A date (day, numeric month, year) in international date format. Символ "/" является логическим разделителем дат и отображается пользователю как разделитель даты, соответствующий текущему языку и региональным параметрам приложения.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 Дата (день, сокращение месяца и год) в США формате, в котором аббревиатура из трех букв отображается в виде первой прописной буквы, за которой следуют две строчные буквы.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 США номер телефона, код города (необязательно).United States phone number, area code optional. Если пользователи не хотят вводить необязательные символы, они могут ввести пробелы или поместить указатель мыши непосредственно в позицию маски, представленной первым 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 Значение валюты в диапазоне от 0 до 999999.A currency value in the range of 0 to 999999. Во время выполнения символы валюты, доли секунды и десятичные знаки будут заменены на их эквиваленты, зависящие от языка и региональных параметров.The currency, thousandth, and decimal characters will be replaced at run time with their culture-specific equivalents.

Применяется к

Дополнительно