MaskedTextBox.RejectInputOnFirstFailure Свойство

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

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

public:
 property bool RejectInputOnFirstFailure { bool get(); void set(bool value); };
public bool RejectInputOnFirstFailure { get; set; }
member this.RejectInputOnFirstFailure : bool with get, set
Public Property RejectInputOnFirstFailure As Boolean

Значение свойства

Boolean

Значение true, если обработка входной строки должна прекращаться после первой ошибки синтаксического анализа, и значение false, если при обработке следует пропускать все ошибки. Значение по умолчанию — false.

Комментарии

Иногда пользователь вводит несколько символов в MaskedTextBox в одной операции ввода, обычно путем копирования и вставки строки. Если вся строка содержит только допустимые символы в соответствии с их позицией вставки во входной маске, вся операция будет выполнена успешно. Однако при возникновении ошибки синтаксического анализа поведение MaskedTextBox зависит от значения RejectInputOnFirstFailure, как показано ниже.

  • Если это свойство равно true, обработка входной строки останавливается на недопустимом символе. Все последующие символы игнорируются. Вызывается одно MaskInputRejected событие.

  • Если это свойство имеет значение false, недопустимый символ отклоняется, но синтаксический анализ продолжается со следующим символом во входной строке. Событие MaskInputRejected вызывается для каждого недопустимого символа во входной строке.

Свойства ResetOnPrompt, ResetOnSpace и SkipLiterals также могут влиять на интерпретацию введенных пользователем данных.

IsOverwriteMode Если свойство имеет значение false, все символы, уже входящие в маску ввода справа от точки вставки, будут вытеснены на допустимое количество символов. Такое смещение может привести к дополнительным ошибкам синтаксического анализа.

Операцию вставки можно имитировать программным способом, задав SelectedText свойство .

Применяется к

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