Bagikan melalui

MaskedTextBox.RejectInputOnFirstFailure Properti

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah penguraian input pengguna harus berhenti setelah karakter pertama yang tidak valid tercapai.

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

Nilai Properti

Boolean

true jika pemrosesan string input harus dihentikan pada kesalahan penguraian pertama; jika tidak, false jika pemrosesan harus mengabaikan semua kesalahan. Default adalah false.

Keterangan

Terkadang pengguna akan memasukkan beberapa karakter ke dalam MaskedTextBox satu operasi input, biasanya dengan menyalin dan menempelkan string. Jika seluruh string hanya berisi karakter yang valid, sesuai dengan posisi tempelnya di masker input, maka seluruh operasi akan berhasil. Namun, ketika kesalahan penguraian MaskedTextBox terjadi, perilaku tergantung pada nilai RejectInputOnFirstFailure, sebagai berikut:

  • Jika properti ini adalah true, maka pemrosesan string input berhenti pada karakter yang tidak valid. Semua karakter berikutnya diabaikan. Satu MaskInputRejected peristiwa dinaikkan.

  • Jika properti ini adalah false, maka karakter yang tidak valid ditolak, tetapi penguraian berlanjut dengan karakter berikutnya dalam string input. Peristiwa MaskInputRejected dimunculkan untuk setiap karakter yang tidak valid dalam string input.

Properti ResetOnPrompt, ResetOnSpace dan SkipLiterals juga dapat memengaruhi interpretasi input pengguna.

IsOverwriteMode Jika properti adalah false, maka karakter apa pun yang sudah ada di masker input di sebelah kanan titik penyisipan akan dipindahkan oleh jumlah karakter yang diterima. Pergeseran ini dapat menyebabkan kesalahan penguraian tambahan.

Operasi penempelan dapat dimigrasikan secara terprogram dengan mengatur SelectedText properti .

Berlaku untuk

Lihat juga