MaskedTextBox.RejectInputOnFirstFailure 属性

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

属性值

如果输入字符串的处理应当在首次出现分析错误时终止，该值为 true；如果处理应忽略所有错误，则为 false。 默认值为 false。

注解

有时，用户会在单个输入操作中将多个字符输入到 MaskedTextBox 中，通常是通过复制和粘贴字符串。 如果整个字符串仅包含有效字符（根据它们在输入掩码中的粘贴位置），则整个操作将成功。 但是，当发生分析错误时， 的行为 MaskedTextBox 取决于 的值 RejectInputOnFirstFailure，如下所示：

• 如果此属性为 true，则输入字符串的处理将在无效字符处停止。 将忽略所有后续字符。 引发单个 MaskInputRejected 事件。

• 如果此属性为 false，则拒绝无效字符，但分析将继续处理输入字符串中的下一个字符。 对于输入字符串中的每个无效字符，都会引发一个 MaskInputRejected 事件。

ResetOnPrompt、 ResetOnSpace 和 SkipLiterals 属性还会影响用户输入的解释。

IsOverwriteMode如果 属性为 false，则插入点右侧输入掩码中已有的任何字符都将由接受的字符数置换。 这种转移可能会导致其他分析错误。

可以通过设置 SelectedText 属性以编程方式模拟粘贴操作。

适用于

另请参阅

• Mask
• MaskInputRejected
• ResetOnPrompt
• ResetOnSpace
• IsOverwriteMode
• SelectedText