Share via


MaskedTextBox.RejectInputOnFirstFailure Özellik

Tanım

İlk geçersiz karaktere ulaşıldıktan sonra kullanıcı girişini ayrıştırma işleminin durdurulup durdurulmayacağını belirten bir değer alır veya ayarlar.

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

Özellik Değeri

true giriş dizesinin işlenmesi ilk ayrıştırma hatasında sonlandırılacaksa; aksi takdirde, false işlemenin tüm hataları yoksayması gerekir. Varsayılan değer: false.

Açıklamalar

Bazen kullanıcı bir dizeyi kopyalayıp yapıştırarak tek bir giriş işlemine MaskedTextBox birkaç karakter girer. Dizenin tamamı giriş maskesindeki yapıştırma konumlarına göre yalnızca geçerli karakterler içeriyorsa, işlemin tamamı başarılı olur. Ancak, ayrıştırma hatası oluştuğunda, davranışı MaskedTextBox aşağıdaki gibi değerine RejectInputOnFirstFailurebağlıdır:

  • Bu özellik ise true, giriş dizesinin işlenmesi geçersiz karakterde durur. Sonraki tüm karakterler yoksayılır. Tek MaskInputRejected bir olay oluşturulur.

  • Bu özellik ise falsegeçersiz karakter reddedilir, ancak ayrıştırma giriş dizesindeki bir sonraki karakterle devam eder. MaskInputRejected Giriş dizesindeki her geçersiz karakter için bir olay oluşturulur.

ResetOnPromptve ResetOnSpaceSkipLiterals özellikleri, kullanıcı girişinin yorumlanmasını da etkileyebilir.

özelliği isefalse, ekleme noktasının IsOverwriteMode sağındaki giriş maskesinde bulunan tüm karakterler kabul edilen karakter sayısıyla değiştirilir. Bu kaydırma ek ayrıştırma hatalarına neden olabilir.

Bir yapıştırma işlemi, özelliği ayarlanarak SelectedText program aracılığıyla taklit edilebilir.

Şunlara uygulanır

Ayrıca bkz.