MaskedTextBox.RejectInputOnFirstFailure Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger ett värde som anger om parsningen av användarindata ska stoppas efter att det första ogiltiga tecknet har nåtts.
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 BooleanEgenskapsvärde
true om bearbetningen av indatasträngen ska avslutas vid det första parsningsfelet; annars, false om bearbetningen bör ignorera alla fel. Standardvärdet är false.
Kommentarer
Ibland anger användaren flera tecken i en MaskedTextBox i en enda indataåtgärd, vanligtvis genom att kopiera och klistra in en sträng. Om hela strängen bara innehåller giltiga tecken, enligt deras inklistringsposition i indatamasken, kommer hela åtgärden att lyckas. Men när ett parsningsfel inträffar beror beteendet MaskedTextBox på värdet för RejectInputOnFirstFailure, enligt följande:
Om den här egenskapen är
truestoppas bearbetningen av indatasträngen med det ogiltiga tecknet. Alla efterföljande tecken ignoreras. En enskild MaskInputRejected händelse utlöses.Om den här egenskapen är
falseavvisas det ogiltiga tecknet, men parsningen fortsätter med nästa tecken i indatasträngen. En MaskInputRejected händelse genereras för varje ogiltigt tecken i indatasträngen.
Egenskaperna ResetOnPromptoch ResetOnSpaceSkipLiterals kan också påverka tolkningen av användarindata.
Om egenskapen IsOverwriteMode är false, kommer alla tecken som redan finns i indatamasken till höger om insättningspunkten att förskjutas av det godkända antalet tecken. Den här växlingen kan orsaka ytterligare parsningsfel.
En inklistrade åtgärd kan efterliknas programmatiskt genom att ange egenskapen SelectedText .
