MaskedTextBox.RejectInputOnFirstFailure Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta un valore che indica se l'analisi dell'input dell'utente deve interrompersi dopo l'individuazione del primo carattere non valido.

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

Valore della proprietà

Boolean

true se l'elaborazione della stringa di input deve essere interrotta in corrispondenza del primo errore di analisi, false se l'elaborazione deve ignorare tutti gli errori. Il valore predefinito è false.

Commenti

A volte l'utente immetterà diversi caratteri in un'unica MaskedTextBox operazione di input, in genere copiando e incollando una stringa. Se l'intera stringa contiene solo caratteri validi, in base alla posizione incollare nella maschera di input, l'intera operazione avrà esito positivo. Tuttavia, quando si verifica un errore di analisi, il comportamento di dipende dal valore di MaskedTextBoxRejectInputOnFirstFailure, come indicato di seguito:

  • Se questa proprietà è true, l'elaborazione della stringa di input si arresta al carattere non valido. Tutti i caratteri successivi vengono ignorati. Viene generato un singolo MaskInputRejected evento.

  • Se questa proprietà è false, il carattere non valido viene rifiutato, ma l'analisi continua con il carattere successivo nella stringa di input. Viene generato un MaskInputRejected evento per ogni carattere non valido nella stringa di input.

Le ResetOnPromptproprietà e SkipLiteralsResetOnSpace possono influire anche sull'interpretazione dell'input dell'utente.

Se la IsOverwriteMode proprietà è false, tutti i caratteri già presenti nella maschera di input a destra del punto di inserimento verranno spostati dal numero accettato di caratteri. Questa modifica può causare errori di analisi aggiuntivi.

Un'operazione di incollatura può essere simulata a livello di codice impostando la SelectedText proprietà.

Si applica a

Vedi anche