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輸入字串中每個無效字元都會引發 事件。

、 ResetOnPromptResetOnSpace 和 SkipLiterals 屬性也會影響使用者輸入的解譯。

IsOverwriteMode如果 屬性是 false ，則插入點右邊的輸入遮罩中已存在的任何字元都會被接受的字元數取代。 此輪班可能會導致額外的剖析錯誤。

您可以藉由設定 SelectedText 屬性，以程式設計方式模擬貼上作業。

另請參閱

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