MaskedTextProvider Класс

Определение

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

System.ComponentModel

Сборка:

System.ComponentModel.TypeConverter.dll

Исходный код:

MaskedTextProvider.cs

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

public ref class MaskedTextProvider : ICloneable

public class MaskedTextProvider : ICloneable

type MaskedTextProvider = class
    interface ICloneable

Public Class MaskedTextProvider
Implements ICloneable

Наследование

Object

MaskedTextProvider

Реализации

ICloneable

Комментарии

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

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

• MaskedTextBox
• MaskedTextProvider
• Mask