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 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, setPublic Property RejectInputOnFirstFailure As BooleanValeur de propriété
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é .
