MaskedTextBox.RejectInputOnFirstFailure Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur indiquant si l’analyse de l’entrée utilisateur doit s’arrêter une fois le premier caractère non valide atteint.
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 BooleanValeur de propriété
true si le traitement de la chaîne d’entrée doit être arrêté lors de 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 une MaskedTextBox seule opération d’entrée, généralement en copiant et en 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 SkipLiterals les ResetOnSpace propriétés peuvent également influencer l’interprétation de l’entrée utilisateur.
Si la IsOverwriteMode propriété est false, les caractères déjà présents dans le masque d’entrée à droite du point d’insertion sont déplacés par le nombre accepté de caractères. Ce déplacement peut entraîner des erreurs d’analyse supplémentaires.
Une opération de collage peut être imite par programmation en définissant la SelectedText propriété.
