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 Событие вызывается для каждого недопустимого символа во входной строке.
ResetOnSpace Свойства ResetOnPromptтакже SkipLiterals могут влиять на интерпретацию входных данных пользователя.
IsOverwriteMode Если свойство имеет значениеfalse, все символы, уже в маске ввода справа от точки вставки, будут перемещены принятым числом символов. Это изменение может привести к дополнительным ошибкам синтаксического анализа.
Операцию вставки можно имитировать программным способом, задав SelectedText свойство.
