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 управления содержит маску, состоящую из литеральных символов и элементов форматирования, с которой проверяются все введенные пользователем данные. Вместо того, чтобы постоянно связывать определенный механизм анализа маски с MaskedTextBox, Windows 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 .
Mask	Представляет маску форматирования входных данных, используемую для преобразования входной строки в форматированную строку. Эта строка задается в MaskedTextProvider и обращается в основном через Mask свойство . Характеристики маски также доступны через другие элементы, такие как Lengthсвойства , PasswordCharи PromptChar .
Форматированная строка	Представляет строку, которая возникает при применении полной маски к входной строке. Форматированная строка может запрашиваться с помощью множества членов класса, включая Item[], , Length, LastAssignedPositionMaskFull, MaskCompleted, FindEditPositionFromи т. д. Полное значение форматируемой строки доступно в методах ToDisplayString и ToString .

Примечание

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

Конструкторы

MaskedTextProvider(String)	Инициализирует новый экземпляр класса MaskedTextProvider, используя заданную маску.
MaskedTextProvider(String, Boolean)	Инициализирует новый экземпляр класса MaskedTextProvider, используя заданную маску и значение ограничения ASCII.
MaskedTextProvider(String, Char, Boolean)	Инициализирует новый экземпляр класса MaskedTextProvider, используя заданную маску, знак пароля и значение использования приглашения.
MaskedTextProvider(String, CultureInfo)	Инициализирует новый экземпляр класса MaskedTextProvider, используя указанные маску и значения языка и региональных параметров.
MaskedTextProvider(String, CultureInfo, Boolean)	Инициализирует новый экземпляр класса MaskedTextProvider, используя заданную маску, язык и региональные параметры, а также значение ограничения ASCII.
MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean)	Инициализирует новый экземпляр класса MaskedTextProvider, используя заданную маску, язык и региональные параметры, значение использования приглашения, символ приглашения, знак пароля и значение ограничения ASCII.
MaskedTextProvider(String, CultureInfo, Char, Boolean)	Инициализирует новый экземпляр класса 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)	Добавляет указанный введенный знак в конец форматируемой строки.
Add(Char, Int32, MaskedTextResultHint)	Добавляет заданный введенный знак в конец форматируемой строки, а затем выводит позицию и описательные сведения.
Add(String)	Добавляет в конец форматируемой строки знаки заданной входной строки.
Add(String, Int32, MaskedTextResultHint)	Добавляет знаки заданной входной строки в конец форматируемой строки, а затем выводит позицию и описательные сведения.
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)	Вставляет заданный знак в заданную позицию форматируемой строки.
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	Вставляет заданный знак в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.
InsertAt(String, Int32)	Вставляет заданную строку в заданную позицию форматируемой строки.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Вставляет заданную строку в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.
IsAvailablePosition(Int32)	Определяет, доступна ли заданная позиция для назначения.
IsEditPosition(Int32)	Определяет, является заданная позиция редактируемой.
IsValidInputChar(Char)	Определяет, является ли заданный знак допустимым для ввода знаком.
IsValidMaskChar(Char)	Определяет, является ли заданный знак допустимым знаком маски.
IsValidPasswordChar(Char)	Определяет, является ли заданный знак допустимым знаком пароля.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Remove()	Удаляет последний назначенный знак из форматируемой строки.
Remove(Int32, MaskedTextResultHint)	Удаляет последний назначенный знак из форматируемой строки, а затем выводит позицию удаления и описательные сведения.
RemoveAt(Int32)	Удаляет назначенный знак в заданной позиции форматируемой строки.
RemoveAt(Int32, Int32)	Удаляет назначенные знаки между заданными позициями форматируемой строки.
RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)	Удаляет назначенные знаки между заданными позициями форматируемой строки, а затем выводит позицию удаления и описательные сведения.
Replace(Char, Int32)	Заменяет один знак в заданной позиции или после нее на заданный знак.
Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)	Заменяет один знак, начиная между заданными начальной и конечной позициями, на заданный знак, а затем выводит позицию удаления и описательные сведения.
Replace(Char, Int32, Int32, MaskedTextResultHint)	Заменяет один знак, начиная с заданной позиции, на заданный знак, а затем выводит позицию удаления и описательные сведения.
Replace(String, Int32)	Заменяет диапазон редактируемых знаков, начиная с заданной позиции в заданной строке.
Replace(String, Int32, Int32, Int32, MaskedTextResultHint)	Заменяет диапазон редактируемых знаков между заданными начальной и конечной позициями на заданную строку, а затем выводит позицию удаления и описательные сведения.
Replace(String, Int32, Int32, MaskedTextResultHint)	Заменяет диапазон редактируемых знаков, начиная с заданной позиции, на заданную строку, а затем выводит позицию удаления и описательные сведения.
Set(String)	Определяет форматируемую строку для заданной входной строки.
Set(String, Int32, MaskedTextResultHint)	Устанавливает форматируемую строку равной заданной входной строке, а затем выводит позицию удаления и описательные сведения.
ToDisplayString()	Возвращает форматируемую строку в отображаемом виде.
ToString()	Возвращает форматируемую строку, содержащую назначенные значения знаков.
ToString(Boolean)	Возвращает форматируемую строку, при необходимости содержащую знаки пароля.
ToString(Boolean, Boolean)	Возвращает форматируемую строку, при необходимости включая знаки приглашения и литералы.
ToString(Boolean, Boolean, Boolean, Int32, Int32)	Возвращает подстроку форматируемой строки, при необходимости включая знаки приглашения, литералы и знаки пароля.
ToString(Boolean, Boolean, Int32, Int32)	Возвращает подстроку форматируемой строки, при необходимости включая знаки приглашения и литералы.
ToString(Boolean, Int32, Int32)	Возвращает подстроку форматируемой строки, при необходимости содержащую знаки пароля.
ToString(Int32, Int32)	Возвращает подстроку форматируемой строки.
VerifyChar(Char, Int32, MaskedTextResultHint)	Проверяет, может ли заданный знак быть успешно установлен в заданной позиции.
VerifyEscapeChar(Char, Int32)	Проверяет, будет ли заданный знак экранироваться в заданной позиции.
VerifyString(String)	Проверяет, может ли заданная строка быть успешно установлена.
VerifyString(String, Int32, MaskedTextResultHint)	Проверяет, может ли заданная строка быть успешно установлена, а затем возвращает позицию и описательные сведения.

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

• MaskedTextBox
• MaskedTextProvider
• Mask