MaskedTextBox.RejectInputOnFirstFailure Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, должен ли прекращаться синтаксический анализ вводимых пользователем данных, когда обнаруживается первый недопустимый символ.
public:
property bool RejectInputOnFirstFailure { bool get(); void set(bool value); };public bool RejectInputOnFirstFailure { get; set; }member this.RejectInputOnFirstFailure : bool with get, setPublic Property RejectInputOnFirstFailure As BooleanЗначение свойства
Значение true, если обработка входной строки должна прекращаться после первой ошибки синтаксического анализа, и значение false, если при обработке следует пропускать все ошибки. Значение по умолчанию — false.
Комментарии
Иногда пользователь вводит несколько символов в MaskedTextBox в одной операции ввода, обычно путем копирования и вставки строки. Если вся строка содержит только допустимые символы в соответствии с их позицией вставки во входной маске, вся операция будет выполнена успешно. Однако при возникновении ошибки синтаксического анализа поведение MaskedTextBox зависит от значения RejectInputOnFirstFailure, как показано ниже.
Если это свойство равно
true, обработка входной строки останавливается на недопустимом символе. Все последующие символы игнорируются. Вызывается одно MaskInputRejected событие.Если это свойство имеет значение
false, недопустимый символ отклоняется, но синтаксический анализ продолжается со следующим символом во входной строке. Событие MaskInputRejected вызывается для каждого недопустимого символа во входной строке.
Свойства ResetOnPrompt, ResetOnSpace и SkipLiterals также могут влиять на интерпретацию введенных пользователем данных.
IsOverwriteMode Если свойство имеет значение false, все символы, уже входящие в маску ввода справа от точки вставки, будут вытеснены на допустимое количество символов. Такое смещение может привести к дополнительным ошибкам синтаксического анализа.
Операцию вставки можно имитировать программным способом, задав SelectedText свойство .
