MaskedTextProvider Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Source:

MaskedTextProvider.cs

Représente un service d’analyse de masque qui peut être utilisé par n’importe quel nombre de contrôles prenant en charge le masquage, tel que le contrôle MaskedTextBox.

public ref class MaskedTextProvider : ICloneable

public class MaskedTextProvider : ICloneable

type MaskedTextProvider = class
    interface ICloneable

Public Class MaskedTextProvider
Implements ICloneable

Héritage

Object

MaskedTextProvider

Implémente

ICloneable

Remarques

Le contrôle MaskedTextBox contient un masque, composé de caractères littéraux et d’éléments de mise en forme, qu’il teste toutes les entrées utilisateur. Au lieu d’associer définitivement un moteur d’analyse de masque spécifique à MaskedTextBox, Windows Forms le fournit en tant que service distinct, représenté par la classe MaskedTextProvider, qui définit la syntaxe du langage de masquage abordé dans la documentation de la propriété Mask.

De nombreux membres de la classe MaskedTextBox font référence à leur implémentation à des membres nommés de la MaskedTextProviderassociée. Par exemple, la propriété MaskedTextBox.PromptChar de la classe MaskedTextBox fait référence à tous les accès aux PromptChar de la classe MaskedTextProvider.

Le moteur d’analyse de masque utilisé par MaskedTextProvider est modélisé après le contrôle Masked Edit inclus dans Microsoft Visual Basic version 6. Sa langue de masquage est décrite dans la documentation de la propriété Mask.

Les trois chaînes distinctes suivantes sont impliquées dans la classe MaskedTextProvider.

Nom de chaîne	Description
Caractère d’entrée ou chaîne	Représente les caractères utilisés comme entrée sur laquelle le masque est appliqué. En réalité, la chaîne d’entrée peut être composée de plusieurs opérations d’entrée, notamment Add, Replace, InsertAtet Remove. Par conséquent, la chaîne d’entrée n’est pas accessible directement. Toutefois, les aspects de la gestion des chaînes d’entrée sont disponibles bien que les propriétés AllowPromptAsInput et AsciiOnly, ResetOnPromptet ResetOnSpace.
Masque	Représente le masque de mise en forme d’entrée utilisé pour transformer la chaîne d’entrée en chaîne mise en forme. Cette chaîne est définie dans le MaskedTextProvider et accessible principalement bien que la propriété Mask. Les caractéristiques du masque sont également disponibles par le biais d’autres membres, tels que les propriétés Length, PasswordCharet PromptChar.
Chaîne mise en forme	Représente la chaîne qui se traduit lorsque le masque complet est appliqué à la chaîne d’entrée. La chaîne mise en forme peut être interrogée avec de nombreux membres de la classe, notamment Item[], Length, LastAssignedPosition, MaskFull, MaskCompleted, FindEditPositionFrom, et ainsi de suite. La valeur complète de la chaîne mise en forme est disponible à partir des méthodes ToDisplayString et ToString.

Note

La chaîne d’entrée peut représenter une entrée utilisateur directe, comme dans le cas de l'MaskedTextBox, ou être générée par d’autres processus qui ne sont pas directement associés aux opérations d’entrée/sortie de l’utilisateur.

Constructeurs

MaskedTextProvider(String, Boolean)	Initialise une nouvelle instance de la classe MaskedTextProvider à l’aide du masque spécifié et de la valeur de restriction ASCII.
MaskedTextProvider(String, Char, Boolean)	Initialise une nouvelle instance de la classe MaskedTextProvider à l’aide du masque, du caractère de mot de passe et de la valeur d’utilisation d’invite spécifiée.
MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean)	Initialise une nouvelle instance de la classe MaskedTextProvider à l’aide du masque, de la culture, de la valeur d’utilisation d’invite, du caractère d’invite, du caractère de mot de passe et de la valeur de restriction ASCII spécifiée.
MaskedTextProvider(String, CultureInfo, Boolean)	Initialise une nouvelle instance de la classe MaskedTextProvider à l’aide du masque, de la culture et de la valeur de restriction ASCII spécifiés.
MaskedTextProvider(String, CultureInfo, Char, Boolean)	Initialise une nouvelle instance de la classe MaskedTextProvider à l’aide du masque, de la culture, du caractère de mot de passe et de la valeur d’utilisation d’invite spécifiée.
MaskedTextProvider(String, CultureInfo)	Initialise une nouvelle instance de la classe MaskedTextProvider à l’aide du masque et de la culture spécifiés.
MaskedTextProvider(String)	Initialise une nouvelle instance de la classe MaskedTextProvider à l’aide du masque spécifié.

Propriétés

AllowPromptAsInput	Obtient une valeur indiquant si le caractère d’invite doit être traité comme un caractère d’entrée valide ou non.
AsciiOnly	Obtient une valeur indiquant si le masque accepte des caractères en dehors du jeu de caractères ASCII.
AssignedEditPositionCount	Obtient le nombre de positions de caractères modifiables qui ont déjà été affectées avec succès à une valeur d’entrée.
AvailableEditPositionCount	Obtient le nombre de positions de caractères modifiables dans le masque d’entrée qui n’ont pas encore été affectées à une valeur d’entrée.
Culture	Obtient la culture qui détermine la valeur des séparateurs localisables et des espaces réservés dans le masque d’entrée.
DefaultPasswordChar	Obtient le caractère de mot de passe par défaut utilisé pour masquer l’entrée utilisateur.
EditPositionCount	Obtient le nombre de positions modifiables dans la chaîne mise en forme.
EditPositions	Obtient un énumérateur nouvellement créé pour les positions modifiables dans la chaîne mise en forme.
IncludeLiterals	Obtient ou définit une valeur qui indique si les caractères littéraux dans le masque d’entrée doivent être inclus dans la chaîne mise en forme.
IncludePrompt	Obtient ou définit une valeur indiquant si PromptChar est utilisé pour représenter l’absence d’entrée utilisateur lors de l’affichage de la chaîne mise en forme.
InvalidIndex	Obtient la limite supérieure de la plage d’index non valides.
IsPassword	Obtient ou définit une valeur qui détermine si la protection par mot de passe doit être appliquée à la chaîne mise en forme.
Item[Int32]	Obtient l’élément à la position spécifiée dans la chaîne mise en forme.
LastAssignedPosition	Obtient l’index dans le masque du caractère d’entrée le plus à droite qui a été affecté au masque.
Length	Obtient la longueur du masque, absent des caractères modificateurs de masque.
Mask	Obtient le masque d’entrée.
MaskCompleted	Obtient une valeur indiquant si toutes les entrées requises ont été entrées dans la chaîne mise en forme.
MaskFull	Obtient une valeur indiquant si toutes les entrées obligatoires et facultatives ont été entrées dans la chaîne mise en forme.
PasswordChar	Obtient ou définit le caractère à remplacer par les caractères d’entrée réels.
PromptChar	Obtient ou définit le caractère utilisé pour représenter l’absence d’entrée utilisateur pour toutes les positions d’édition disponibles.
ResetOnPrompt	Obtient ou définit une valeur qui détermine comment un caractère d’entrée qui correspond au caractère d’invite doit être géré.
ResetOnSpace	Obtient ou définit une valeur qui détermine la façon dont un caractère d’entrée d’espace doit être géré.
SkipLiterals	Obtient ou définit une valeur indiquant si les positions de caractère littéral dans le masque peuvent être remplacées par leurs mêmes valeurs.

Méthodes

Add(Char, Int32, MaskedTextResultHint)	Ajoute le caractère d’entrée spécifié à la fin de la chaîne mise en forme, puis génère des informations descriptives et de position.
Add(Char)	Ajoute le caractère d’entrée spécifié à la fin de la chaîne mise en forme.
Add(String, Int32, MaskedTextResultHint)	Ajoute les caractères de la chaîne d’entrée spécifiée à la fin de la chaîne mise en forme, puis génère des informations descriptives et de position.
Add(String)	Ajoute les caractères de la chaîne d’entrée spécifiée à la fin de la chaîne mise en forme.
Clear()	Efface tous les caractères d’entrée modifiables de la chaîne mise en forme, en les remplaçant par des caractères d’invite.
Clear(MaskedTextResultHint)	Efface tous les caractères d’entrée modifiables de la chaîne mise en forme, en les remplaçant par des caractères d’invite, puis génère des informations descriptives.
Clone()	Crée une copie du MaskedTextProvideractuel .
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FindAssignedEditPositionFrom(Int32, Boolean)	Retourne la position de la première position modifiable affectée après la position spécifiée à l’aide de la direction de recherche spécifiée.
FindAssignedEditPositionInRange(Int32, Int32, Boolean)	Retourne la position de la première position modifiable affectée entre les positions spécifiées à l’aide de la direction de recherche spécifiée.
FindEditPositionFrom(Int32, Boolean)	Retourne la position de la première position modifiable après la position spécifiée à l’aide de la direction de recherche spécifiée.
FindEditPositionInRange(Int32, Int32, Boolean)	Retourne la position de la première position modifiable entre les positions spécifiées à l’aide de la direction de recherche spécifiée.
FindNonEditPositionFrom(Int32, Boolean)	Retourne la position de la première position non modifiable après la position spécifiée à l’aide de la direction de recherche spécifiée.
FindNonEditPositionInRange(Int32, Int32, Boolean)	Retourne la position de la première position non modifiable entre les positions spécifiées à l’aide de la direction de recherche spécifiée.
FindUnassignedEditPositionFrom(Int32, Boolean)	Retourne la position de la première position modifiable non attribuée après la position spécifiée à l’aide de la direction de recherche spécifiée.
FindUnassignedEditPositionInRange(Int32, Int32, Boolean)	Retourne la position de la première position modifiable non attribuée entre les positions spécifiées à l’aide de la direction de recherche spécifiée.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetOperationResultFromHint(MaskedTextResultHint)	Détermine si le MaskedTextResultHint spécifié indique la réussite ou l’échec.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	Insère le caractère spécifié à la position spécifiée dans la chaîne mise en forme, en retournant la dernière position d’insertion et l’état de l’opération.
InsertAt(Char, Int32)	Insère le caractère spécifié à la position spécifiée dans la chaîne mise en forme.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Insère la chaîne spécifiée à une position spécifiée dans la chaîne mise en forme, retournant la dernière position d’insertion et l’état de l’opération.
InsertAt(String, Int32)	Insère la chaîne spécifiée à une position spécifiée dans la chaîne mise en forme.
IsAvailablePosition(Int32)	Détermine si la position spécifiée est disponible pour l’affectation.
IsEditPosition(Int32)	Détermine si la position spécifiée est modifiable.
IsValidInputChar(Char)	Détermine si le caractère spécifié est un caractère d’entrée valide.
IsValidMaskChar(Char)	Détermine si le caractère spécifié est un caractère de masque valide.
IsValidPasswordChar(Char)	Détermine si le caractère spécifié est un caractère de mot de passe valide.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
Remove()	Supprime le dernier caractère affecté de la chaîne mise en forme.
Remove(Int32, MaskedTextResultHint)	Supprime le dernier caractère attribué de la chaîne mise en forme, puis génère la position de suppression et les informations descriptives.
RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)	Supprime les caractères attribués entre les positions spécifiées de la chaîne mise en forme, puis génère la position de suppression et les informations descriptives.
RemoveAt(Int32, Int32)	Supprime les caractères attribués entre les positions spécifiées de la chaîne mise en forme.
RemoveAt(Int32)	Supprime le caractère affecté à la position spécifiée de la chaîne mise en forme.
Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)	Remplace un caractère unique entre les positions de début et de fin spécifiées par la valeur de caractère spécifiée, puis génère la position de suppression et les informations descriptives.
Replace(Char, Int32, Int32, MaskedTextResultHint)	Remplace un caractère unique à ou au-delà de la position spécifiée par la valeur de caractère spécifiée, puis génère la position de suppression et les informations descriptives.
Replace(Char, Int32)	Remplace un caractère unique à ou au-delà de la position spécifiée par la valeur de caractère spécifiée.
Replace(String, Int32, Int32, Int32, MaskedTextResultHint)	Remplace une plage de caractères modifiables entre les positions de début et de fin spécifiées par la chaîne spécifiée, puis génère la position de suppression et les informations descriptives.
Replace(String, Int32, Int32, MaskedTextResultHint)	Remplace une plage de caractères modifiables commençant à la position spécifiée par la chaîne spécifiée, puis génère la position de suppression et les informations descriptives.
Replace(String, Int32)	Remplace une plage de caractères modifiables commençant à la position spécifiée par la chaîne spécifiée.
Set(String, Int32, MaskedTextResultHint)	Définit la chaîne mise en forme sur la chaîne d’entrée spécifiée, puis génère la position de suppression et les informations descriptives.
Set(String)	Définit la chaîne mise en forme sur la chaîne d’entrée spécifiée.
ToDisplayString()	Retourne la chaîne mise en forme dans un formulaire affichable.
ToString()	Retourne la chaîne mise en forme qui inclut toutes les valeurs de caractères attribuées.
ToString(Boolean, Boolean, Boolean, Int32, Int32)	Retourne une sous-chaîne de la chaîne mise en forme, y compris éventuellement les caractères d’invite, de littéral et de mot de passe.
ToString(Boolean, Boolean, Int32, Int32)	Retourne une sous-chaîne de la chaîne mise en forme, y compris éventuellement les caractères d’invite et de littéral.
ToString(Boolean, Boolean)	Retourne la chaîne mise en forme, y compris éventuellement les caractères d’invite et de littéral.
ToString(Boolean, Int32, Int32)	Retourne une sous-chaîne de la chaîne mise en forme, y compris éventuellement les caractères de mot de passe.
ToString(Boolean)	Retourne la chaîne mise en forme, y compris éventuellement les caractères de mot de passe.
ToString(Int32, Int32)	Retourne une sous-chaîne de la chaîne mise en forme.
VerifyChar(Char, Int32, MaskedTextResultHint)	Teste si le caractère spécifié peut être défini avec succès à la position spécifiée.
VerifyEscapeChar(Char, Int32)	Teste si le caractère spécifié est échappé à la position spécifiée.
VerifyString(String, Int32, MaskedTextResultHint)	Teste si la chaîne spécifiée peut être définie correctement, puis génère des informations descriptives et de position.
VerifyString(String)	Teste si la chaîne spécifiée peut être définie avec succès.

Voir aussi

• MaskedTextBox
• MaskedTextProvider
• Mask