MaskedTextBox.RejectInputOnFirstFailure Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu urč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, setPublic Property RejectInputOnFirstFailure As BooleanHodnota vlastnosti
true je-li zpracování vstupního řetězce ukončeno při první chybě analýzy; jinak, false pokud by zpracování mělo ignorovat všechny chyby. Výchozí hodnota je false.
Poznámky
Někdy 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 závisí na hodnotě RejectInputOnFirstFailure, následujícím způsobem:
Pokud je
truetato vlastnost , zpracování vstupního řetězce se zastaví na neplatném znaku. Všechny následující znaky se ignorují. Vyvolá se jedna MaskInputRejected událost.Pokud je
falsetato vlastnost , je neplatný znak odmítnut, 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 ResetOnPrompta SkipLiterals vlastnosti ResetOnSpace mohou také ovlivnit interpretaci vstupu uživatele.
IsOverwriteMode Pokud je falsevlastnost , všechny znaky již ve vstupní masce napravo od kurzoru budou nahrazeny přijatým počtem znaků. Tento posun může způsobit další chyby analýzy.
Vložení operace lze mimickovat programově nastavením SelectedText vlastnosti.
