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 です。

注釈

ユーザーが 1 回の入力操作で 複数の文字を に MaskedTextBox 入力する場合があります。通常は、文字列をコピーして貼り付けます。 文字列全体に有効な文字のみが含まれている場合は、入力マスク内の貼り付け位置に従って、操作全体が成功します。 ただし、解析エラーが発生した場合、 の MaskedTextBox 動作は、 の RejectInputOnFirstFailure値によって次のように異なります。

  • このプロパティが の場合、 true入力文字列の処理は無効な文字で停止します。 後続のすべての文字は無視されます。 1 つの MaskInputRejected イベントが発生します。

  • このプロパティが の場合、 false無効な文字は拒否されますが、解析は入力文字列の次の文字で続行されます。 MaskInputRejected入力文字列内のすべての無効な文字に対してイベントが発生します。

、ResetOnSpaceおよび SkipLiterals プロパティはResetOnPrompt、ユーザー入力の解釈にも影響を与える可能性があります。

プロパティが IsOverwriteMode の場合、 false挿入ポイントの右側にある入力マスクに既に含まれている文字は、許容される文字数だけ移動されます。 このシフトにより、追加の解析エラーが発生する可能性があります。

貼り付け操作は、 プロパティを設定 SelectedText することでプログラムで模倣できます。

適用対象

こちらもご覧ください