MaskedTextBox.RejectInputOnFirstFailure Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het parseren van gebruikersinvoer moet stoppen nadat het eerste ongeldige teken is bereikt.
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 BooleanWaarde van eigenschap
true als de verwerking van de invoertekenreeks moet worden beëindigd bij de eerste parseringsfout; false anders worden alle fouten genegeerd als de verwerking alle fouten moet negeren. De standaardwaarde is false.
Opmerkingen
Soms voert de gebruiker meerdere tekens in één MaskedTextBox invoerbewerking in, meestal door een tekenreeks te kopiëren en plakken. Als de hele tekenreeks alleen geldige tekens bevat, volgens de plakpositie in het invoermasker, slaagt de hele bewerking. Wanneer er echter een parseringsfout optreedt, is het gedrag afhankelijk van MaskedTextBox de waarde van RejectInputOnFirstFailure, als volgt:
Als deze eigenschap is
true, stopt de verwerking van de invoertekenreeks bij het ongeldige teken. Alle volgende tekens worden genegeerd. Er wordt één MaskInputRejected gebeurtenis gegenereerd.Als deze eigenschap is
false, wordt het ongeldige teken geweigerd, maar het parseren gaat verder met het volgende teken in de invoertekenreeks. Er wordt een MaskInputRejected gebeurtenis gegenereerd voor elk ongeldig teken in de invoertekenreeks.
De ResetOnPrompten ResetOnSpaceSkipLiterals eigenschappen kunnen ook invloed hebben op de interpretatie van de gebruikersinvoer.
Als de IsOverwriteMode eigenschap is false, worden alle tekens die zich al in het invoermasker rechts van de invoegpositie bevinden, verplaatst door het geaccepteerde aantal tekens. Deze verschuiving kan extra parseringsfouten veroorzaken.
Een plakbewerking kan programmatisch worden nagebootst door de SelectedText eigenschap in te stellen.
