Sdílet prostřednictvím


MaskedTextBox.RejectInputOnFirstFailure Vlastnost

Definice

Získá nebo nastaví hodnotu označující, zda analýza uživatelského vstupu by se měla zastavit po dosažení prvního neplatného znaku.

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

Hodnota vlastnosti

true má-li být zpracování vstupního řetězce ukončeno při první chybě analýzy; v opačném případě by false zpracování mělo ignorovat všechny chyby. Výchozí formát je false.

Poznámky

V některých případech uživatel zadá několik znaků do MaskedTextBox jedné vstupní operace, obvykle zkopírováním a vložením řetězce. Pokud celý řetězec obsahuje pouze platné znaky podle jejich pozice vložení ve vstupní masce, celá operace bude úspěšná. Pokud však dojde k chybě analýzy, chování MaskedTextBox objektu závisí na hodnotě RejectInputOnFirstFailure, a to následujícím způsobem:

  • Pokud je truetato vlastnost , zastaví se zpracování vstupního řetězce na neplatném znaku. Všechny následující znaky se ignorují. Vyvolá se jedna MaskInputRejected událost.

  • Pokud je falsetato vlastnost , neplatný znak se odmítne, ale analýza pokračuje dalším znakem ve vstupním řetězci. Událost MaskInputRejected je vyvolána pro každý neplatný znak ve vstupním řetězci.

Vlastnosti ResetOnPrompt, ResetOnSpace a SkipLiterals mohou také ovlivnit interpretaci vstupu uživatele.

IsOverwriteMode Pokud je falsevlastnost , všechny znaky, které už jsou ve vstupní masce napravo od místa vložení, budou nahrazeny akceptovaným počtem znaků. Toto posunutí může způsobit další chyby analýzy.

Operaci vložení lze napodobovat programově nastavením SelectedText vlastnosti .

Platí pro

Viz také