MaskedTextBox.RejectInputOnFirstFailure 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置一个值，该值指示当遇到第一个无效字符时，是否应停止对用户输入的分析。
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 属性以编程方式模拟粘贴操作。
