MaskedTextBox.RejectInputOnFirstFailure Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si l'analyse de l'entrée d'utilisateur doit s'arrêter après que le premier caractère non valide est atteint.

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

Valeur de propriété

Boolean

true si le traitement de la chaîne d'entrée doit être terminé à la première erreur d'analyse ; sinon, false si le traitement doit ignorer toutes les erreurs. La valeur par défaut est false.

Remarques

Parfois, l’utilisateur entre plusieurs caractères dans un dans une MaskedTextBox seule opération d’entrée, généralement en copiant et collant une chaîne. Si la chaîne entière contient uniquement des caractères valides, en fonction de leur position de collage dans le masque d’entrée, l’opération entière réussit. Toutefois, lorsqu’une erreur d’analyse se produit, le comportement de dépend de MaskedTextBox la valeur de RejectInputOnFirstFailure, comme suit :

  • Si cette propriété est true, le traitement de la chaîne d’entrée s’arrête au caractère non valide. Tous les caractères suivants sont ignorés. Un événement unique MaskInputRejected est déclenché.

  • Si cette propriété est false, le caractère non valide est rejeté, mais l’analyse continue avec le caractère suivant dans la chaîne d’entrée. Un MaskInputRejected événement est déclenché pour chaque caractère non valide dans la chaîne d’entrée.

Les ResetOnPromptpropriétés et SkipLiteralsResetOnSpace peuvent également influencer l’interprétation de l’entrée utilisateur.

Si la IsOverwriteMode propriété est false, tous les caractères déjà présents dans le masque d’entrée à droite du point d’insertion seront déplacés par le nombre de caractères accepté. Ce changement peut entraîner des erreurs d’analyse supplémentaires.

Une opération de collage peut être imitée par programme en définissant la SelectedText propriété .

S’applique à

Voir aussi