MaskedTextProvider Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет службу синтаксического анализа маски, которая может использоваться любым количеством элементов управления, поддерживающих маскирование, например элемент управления MaskedTextBox.
public ref class MaskedTextProvider : ICloneablepublic class MaskedTextProvider : ICloneabletype MaskedTextProvider = class
interface ICloneablePublic Class MaskedTextProvider
Implements ICloneable- Наследование
-
MaskedTextProvider
- Реализации
Комментарии
Элемент управления MaskedTextBox содержит маску, состоящую из литеральных символов и элементов форматирования, с которыми он проверяет все входные данные пользователя. Вместо постоянного связывания определенного обработчика анализа маски с MaskedTextBoxWindows Forms предоставляет его как отдельную службу, представленную классом MaskedTextProvider, который определяет синтаксис языка маскирования, рассмотренного в документации для свойства Mask.
Многие члены класса MaskedTextBox ссылаются на их реализацию на аналогичные именованные элементы связанного MaskedTextProvider. Например, свойство MaskedTextBox.PromptChar класса MaskedTextBox ссылается на все доступы к PromptChar класса MaskedTextProvider.
Модуль синтаксического анализа маски, используемый MaskedTextProvider, моделировается после включения элемента управления "Маскированные изменения" в Microsoft Visual Basic версии 6. Его язык маскирования описан в документации по свойству Mask.
Следующие три отдельные строки связаны с классом MaskedTextProvider.
| Имя строки | Описание |
|---|---|
| Входной символ или строка | Представляет символы, используемые в качестве входных данных, к которым применяется маска. В действительности входная строка может состоять из нескольких операций ввода, включая Add, Replace, InsertAtи Remove. Таким образом, доступ к входной строке невозможен напрямую. Однако аспекты обработки входной строки доступны, хотя свойства AllowPromptAsInput и AsciiOnly, ResetOnPromptи ResetOnSpace. |
| Маска | Представляет маску форматирования входных данных, используемую для преобразования входной строки в отформатированную строку. Эта строка задана в MaskedTextProvider и обращается в первую очередь к свойству Mask. Характеристики маски также доступны через другие элементы, такие как свойства Length, PasswordCharи PromptChar. |
| Форматированная строка | Представляет строку, которая приводит к применению полной маски к входной строке. Форматированная строка может запрашиваться со многими членами класса, включая Item[], Length, LastAssignedPosition, MaskFull, MaskCompleted, FindEditPositionFromи т. д. Полное значение форматируемой строки доступно из методов ToDisplayString и ToString. |
Заметка
Входная строка может представлять прямые входные данные пользователя, как в случае MaskedTextBox, или создаваться другими процессами, не связанными напрямую с операциями ввода и вывода пользователя.
Конструкторы
| MaskedTextProvider(String, Boolean) |
Инициализирует новый экземпляр класса MaskedTextProvider с помощью указанного значения маски и ограничения ASCII. |
| MaskedTextProvider(String, Char, Boolean) |
Инициализирует новый экземпляр класса MaskedTextProvider с помощью указанной маски, символа пароля и значения использования запроса. |
| MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean) |
Инициализирует новый экземпляр класса MaskedTextProvider с помощью указанной маски, языка и региональных параметров, значения использования запроса, символа запроса, символа пароля и ограничения ASCII. |
| MaskedTextProvider(String, CultureInfo, Boolean) |
Инициализирует новый экземпляр класса MaskedTextProvider с помощью указанного значения ограничения маски, языка и региональных параметров и ASCII. |
| MaskedTextProvider(String, CultureInfo, Char, Boolean) |
Инициализирует новый экземпляр класса MaskedTextProvider с помощью указанной маски, языка и региональных параметров, символа пароля и значения использования запроса. |
| MaskedTextProvider(String, CultureInfo) |
Инициализирует новый экземпляр класса MaskedTextProvider с помощью указанной маски и языка и региональных параметров. |
| MaskedTextProvider(String) |
Инициализирует новый экземпляр класса MaskedTextProvider с помощью указанной маски. |
Свойства
| AllowPromptAsInput |
Возвращает значение, указывающее, должен ли символ запроса рассматриваться как допустимый входной символ или нет. |
| AsciiOnly |
Возвращает значение, указывающее, принимает ли маска символы за пределами набора символов ASCII. |
| AssignedEditPositionCount |
Возвращает количество редактируемых позиций символов, которые уже были успешно назначены входным значением. |
| AvailableEditPositionCount |
Возвращает количество редактируемых позиций символов в маске ввода, которые еще не назначены входным значением. |
| Culture |
Возвращает язык и региональные параметры, определяющие значение локализуемых разделителей и заполнителей в маске ввода. |
| DefaultPasswordChar |
Возвращает символ пароля по умолчанию, используемый неясным пользовательским вводом. |
| EditPositionCount |
Возвращает количество редактируемых позиций в отформатируемой строке. |
| EditPositions |
Возвращает только что созданный перечислитель для редактируемых позиций в отформатируемой строке. |
| IncludeLiterals |
Возвращает или задает значение, указывающее, должны литералы в маске ввода включаться в форматированную строку. |
| IncludePrompt |
Возвращает или задает значение, указывающее, используется ли PromptChar для представления отсутствия входных данных пользователя при отображении отформатируемой строки. |
| InvalidIndex |
Возвращает верхнюю границу диапазона недопустимых индексов. |
| IsPassword |
Возвращает или задает значение, определяющее, следует ли применять защиту паролей к форматируемой строке. |
| Item[Int32] |
Возвращает элемент в указанной позиции в отформатируемой строке. |
| LastAssignedPosition |
Получает индекс в маске самого правого входного символа, который был назначен маске. |
| Length |
Возвращает длину маски, отсутствуют любые символы модификатора маски. |
| Mask |
Возвращает маску ввода. |
| MaskCompleted |
Возвращает значение, указывающее, были ли введены все необходимые входные данные в форматированную строку. |
| MaskFull |
Возвращает значение, указывающее, были ли введены все необходимые и необязательные входные данные в отформатированную строку. |
| PasswordChar |
Возвращает или задает символ, заменяющий фактические входные символы. |
| PromptChar |
Возвращает или задает символ, используемый для представления отсутствия входных данных пользователя для всех доступных позиций редактирования. |
| ResetOnPrompt |
Возвращает или задает значение, определяющее способ обработки входного символа, соответствующего символу запроса. |
| ResetOnSpace |
Возвращает или задает значение, определяющее способ обработки символа ввода пространства. |
| SkipLiterals |
Возвращает или задает значение, указывающее, могут ли литеральные позиции символов в маске быть перезаписаны одинаковыми значениями. |
Методы
| Add(Char, Int32, MaskedTextResultHint) |
Добавляет указанный входной символ в конец форматируемой строки, а затем выводит позицию и описательную информацию. |
| Add(Char) |
Добавляет указанный входной символ в конец отформатируемой строки. |
| Add(String, Int32, MaskedTextResultHint) |
Добавляет символы в указанную входную строку в конец форматируемой строки, а затем выводит позицию и описательную информацию. |
| Add(String) |
Добавляет символы в указанную входную строку в конец форматируемой строки. |
| Clear() |
Очищает все редактируемые входные символы из форматируемой строки, заменив их символами запроса. |
| Clear(MaskedTextResultHint) |
Очищает все редактируемые входные символы из форматируемой строки, заменяя их символами запроса, а затем выводит описательные сведения. |
| Clone() |
Создает копию текущей MaskedTextProvider. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| FindAssignedEditPositionFrom(Int32, Boolean) |
Возвращает позицию первой назначенной редактируемой позиции после указанной позиции с помощью указанного направления поиска. |
| FindAssignedEditPositionInRange(Int32, Int32, Boolean) |
Возвращает позицию первой назначенной редактируемой позиции между указанными позициями с помощью указанного направления поиска. |
| FindEditPositionFrom(Int32, Boolean) |
Возвращает позицию первой редактируемой позиции после указанной позиции с помощью указанного направления поиска. |
| FindEditPositionInRange(Int32, Int32, Boolean) |
Возвращает позицию первой редактируемой позиции между указанными позициями с помощью указанного направления поиска. |
| FindNonEditPositionFrom(Int32, Boolean) |
Возвращает позицию первой нередактируемой позиции после указанной позиции с помощью указанного направления поиска. |
| FindNonEditPositionInRange(Int32, Int32, Boolean) |
Возвращает позицию первой не редактируемой позиции между указанными позициями с помощью указанного направления поиска. |
| FindUnassignedEditPositionFrom(Int32, Boolean) |
Возвращает позицию первой неназначаемой редактируемой позиции после указанной позиции с помощью указанного направления поиска. |
| FindUnassignedEditPositionInRange(Int32, Int32, Boolean) |
Возвращает позицию первой неназначаемой редактируемой позиции между указанными позициями с помощью указанного направления поиска. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetOperationResultFromHint(MaskedTextResultHint) |
Определяет, обозначает ли указанный MaskedTextResultHint успех или сбой. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| InsertAt(Char, Int32, Int32, MaskedTextResultHint) |
Вставляет указанный символ в указанную позицию в форматируемой строке, возвращая последнюю позицию вставки и состояние операции. |
| InsertAt(Char, Int32) |
Вставляет указанный символ в указанную позицию в форматируемой строке. |
| InsertAt(String, Int32, Int32, MaskedTextResultHint) |
Вставляет указанную строку в указанную позицию в форматируемой строке, возвращая последнюю позицию вставки и состояние операции. |
| InsertAt(String, Int32) |
Вставляет указанную строку в указанную позицию в форматируемой строке. |
| IsAvailablePosition(Int32) |
Определяет, доступна ли указанная позиция для назначения. |
| IsEditPosition(Int32) |
Определяет, является ли указанная позиция редактируемой. |
| IsValidInputChar(Char) |
Определяет, является ли указанный символ допустимым входным символом. |
| IsValidMaskChar(Char) |
Определяет, является ли указанный символ допустимым символом маски. |
| IsValidPasswordChar(Char) |
Определяет, является ли указанный символ допустимым символом пароля. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| Remove() |
Удаляет последний назначенный символ из форматируемой строки. |
| Remove(Int32, MaskedTextResultHint) |
Удаляет последний назначенный символ из форматируемой строки, а затем выводит позицию удаления и описательную информацию. |
| RemoveAt(Int32, Int32, Int32, MaskedTextResultHint) |
Удаляет назначенные символы между указанными позициями из отформатируемой строки, а затем выводит позицию удаления и описательную информацию. |
| RemoveAt(Int32, Int32) |
Удаляет назначенные символы между указанными позициями из форматируемой строки. |
| RemoveAt(Int32) |
Удаляет назначенный символ в указанной позиции из отформатируемой строки. |
| Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) |
Заменяет один символ между указанными начальными и конечными позициями указанным значением символа, а затем выводит позицию удаления и описательную информацию. |
| Replace(Char, Int32, Int32, MaskedTextResultHint) |
Заменяет один символ в указанной позиции или за ее пределами указанным значением символа, а затем выводит позицию удаления и описательную информацию. |
| Replace(Char, Int32) |
Заменяет один символ в указанной позиции или за пределами указанной позиции указанным значением символа. |
| Replace(String, Int32, Int32, Int32, MaskedTextResultHint) |
Заменяет диапазон редактируемых символов между указанными начальными и конечными позициями указанной строкой, а затем выводит позицию удаления и описательную информацию. |
| Replace(String, Int32, Int32, MaskedTextResultHint) |
Заменяет диапазон редактируемых символов, начиная с указанной позиции с указанной строкой, а затем выводит позицию удаления и описательную информацию. |
| Replace(String, Int32) |
Заменяет диапазон редактируемых символов, начиная с указанной позиции указанной строкой. |
| Set(String, Int32, MaskedTextResultHint) |
Задает отформатированную строку в указанную входную строку, а затем выводит позицию удаления и описательную информацию. |
| Set(String) |
Задает отформатированную строку в указанную входную строку. |
| ToDisplayString() |
Возвращает отформатированную строку в отображаемой форме. |
| ToString() |
Возвращает отформатированную строку, содержащую все назначенные значения символов. |
| ToString(Boolean, Boolean, Boolean, Int32, Int32) |
Возвращает подстроку форматируемой строки, в том числе символы запроса, литерала и пароля. |
| ToString(Boolean, Boolean, Int32, Int32) |
Возвращает подстроку форматируемой строки, включая символы запроса и литерала. |
| ToString(Boolean, Boolean) |
Возвращает отформатированную строку, в том числе символы запроса и литерала. |
| ToString(Boolean, Int32, Int32) |
Возвращает подстроку форматируемой строки, в том числе символы пароля. |
| ToString(Boolean) |
Возвращает отформатированную строку, в том числе символы пароля. |
| ToString(Int32, Int32) |
Возвращает подстроку форматируемой строки. |
| VerifyChar(Char, Int32, MaskedTextResultHint) |
Проверяет, может ли указанный символ быть успешно задан в указанной позиции. |
| VerifyEscapeChar(Char, Int32) |
Проверяет, будет ли указанный символ экранироваться в указанной позиции. |
| VerifyString(String, Int32, MaskedTextResultHint) |
Проверяет, может ли указанная строка быть успешно задана, а затем выводит позицию и описательную информацию. |
| VerifyString(String) |
Проверяет, может ли указанная строка быть успешно задана. |
