MaskedTextProvider Classe

Définition

Représente un service d'analyse de masque qui peut être utilisé par n'importe quel nombre de contrôles qui prennent 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
MaskedTextProvider
Implémente

Remarques

Le MaskedTextBox contrôle contient un masque, composé de caractères littérals et d’éléments de mise en forme, sur lequel 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 MaskedTextProvider classe, qui définit la syntaxe du langage de masquage abordé dans la documentation de la Mask propriété.

La plupart des membres de la MaskedTextBox classe font référence à leur implémentation à des membres nommés de la même façon de l’objet associé MaskedTextProvider. Par exemple, la MaskedTextBox.PromptChar propriété de la MaskedTextBox classe fait référence à tous les accès au PromptChar de la MaskedTextProvider classe .

Le moteur d’analyse de masque utilisé par MaskedTextProvider est modélisé d’après le contrôle Modification masquée inclus dans Microsoft Visual Basic version 6. Son langage de masquage est décrit dans la documentation de la Mask propriété .

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

Nom de la chaîne Description
Caractère ou chaîne d’entrée 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, certains aspects de la gestion des chaînes d’entrée sont disponibles via les AllowPromptAsInput propriétés et AsciiOnly, ResetOnPromptet ResetOnSpace .
Mask 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 par le biais de la Mask propriété . Les caractéristiques du masque sont également disponibles via d’autres membres, tels que les Lengthpropriétés , PasswordCharet PromptChar .
Chaîne mise en forme Représente la chaîne qui se produit 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[], , LastAssignedPositionLengthMaskFull, MaskCompleted, FindEditPositionFrom, , et ainsi de suite. La valeur complète de la chaîne mise en forme est disponible à partir des ToDisplayString méthodes et ToString .

Notes

La chaîne d’entrée peut représenter une entrée utilisateur directe, comme dans le cas de , MaskedTextBoxou peut ê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)

Initialise une nouvelle instance de la classe MaskedTextProvider à l'aide du masque spécifié.

MaskedTextProvider(String, Boolean)

Initialise une nouvelle instance de la classe MaskedTextProvider à l'aide de la valeur de restriction ASCII et du masque spécifié.

MaskedTextProvider(String, Char, Boolean)

Initialise une nouvelle instance de la classe MaskedTextProvider à l'aide du masque spécifié, du caractère de mot de passe, et de la valeur d'utilisation de l'invite.

MaskedTextProvider(String, CultureInfo)

Initialise une nouvelle instance de la classe MaskedTextProvider à l'aide du masque et de la culture spécifiés.

MaskedTextProvider(String, CultureInfo, Boolean)

Initialise une nouvelle instance de la classe MaskedTextProvider à l'aide de la valeur de restriction ASCII, du masque et de la culture spécifiés.

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 de l'invite, du caractère d'invite, du caractère de mot de passe 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 de l'invite spécifiés.

Propriétés

AllowPromptAsInput

Obtient une valeur qui indique si le caractère d'invite doit être traité comme un caractère d'entrée valide ou pas.

AsciiOnly

Obtient une valeur qui indique si le masque accepte des caractères en dehors du jeu de caractères ASCII.

AssignedEditPositionCount

Obtient le nombre de positions de caractère modifiables auxquelles une valeur d'entrée a déjà été correctement assignée.

AvailableEditPositionCount

Obtient le nombre de positions de caractère modifiables dans le masque de saisie auxquelles aucune valeur d'entrée n'a encore été assignée.

Culture

Obtient la culture qui détermine la valeur des séparateurs localisables et des espaces réservés dans le masque de saisie.

DefaultPasswordChar

Obtient le caractère de mot de passe par défaut utilisé pour masquer l'entrée d'utilisateur.

EditPositionCount

Obtient le nombre de positions modifiables dans la chaîne mise en forme.

EditPositions

Obtient un énumérateur créé récemment 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 de saisie doivent être inclus dans la chaîne mise en forme.

IncludePrompt

Obtient ou définit une valeur qui indique si PromptChar est utilisé pour représenter l'absence d'entrée d'utilisateur lors de l'affichage de la chaîne mise en forme.

InvalidIndex

Obtient la limite supérieure de la plage des 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 assigné au masque.

Length

Obtient la longueur du masque, sans les caractères du modificateur du masque.

Mask

Obtient le masque de saisie.

MaskCompleted

Obtient une valeur qui indique si toutes les entrées requises ont été entrées dans la chaîne mise en forme.

MaskFull

Obtient une valeur qui indique 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 à substituer aux caractères d'entrée réels.

PromptChar

Obtient ou définit le caractère utilisé pour représenter l'absence d'entrée d'utilisateur pour toutes les positions de modification 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 comment un caractère d'entrée d'espace doit être géré.

SkipLiterals

Obtient ou définit une valeur qui indique si les positions de caractères littéraux dans le masque peuvent être remplacées par leurs mêmes valeurs.

Méthodes

Add(Char)

Ajoute le caractère d'entrée spécifié à la fin de la chaîne mise en forme.

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 les informations descriptives et de position.

Add(String)

Ajoute les caractères dans la chaîne d'entrée spécifiée à la fin de la chaîne mise en forme.

Add(String, Int32, MaskedTextResultHint)

Ajoute les caractères dans la chaîne d'entrée spécifiée à la fin de la chaîne mise en forme, puis génère les informations descriptives et de position.

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 les informations descriptives.

Clone()

Crée une copie de l'élément MaskedTextProvider actuel.

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 assignée après la position spécifiée à l'aide du sens de la recherche spécifié.

FindAssignedEditPositionInRange(Int32, Int32, Boolean)

Retourne la position de la première position modifiable assignée entre les positions spécifiées à l'aide du sens de la recherche spécifié.

FindEditPositionFrom(Int32, Boolean)

Retourne la position de la première position modifiable après la position spécifiée à l'aide du sens de la recherche spécifié.

FindEditPositionInRange(Int32, Int32, Boolean)

Retourne la position de la première position modifiable entre les positions spécifiées à l'aide du sens de la recherche spécifié.

FindNonEditPositionFrom(Int32, Boolean)

Retourne la position de la première position non modifiable après la position spécifiée à l'aide du sens de la recherche spécifié.

FindNonEditPositionInRange(Int32, Int32, Boolean)

Retourne la position de la première position non modifiable entre les positions spécifiées à l'aide du sens de la recherche spécifié.

FindUnassignedEditPositionFrom(Int32, Boolean)

Retourne la position de la première position modifiable non assignée après la position spécifiée à l'aide du sens de la recherche spécifié.

FindUnassignedEditPositionInRange(Int32, Int32, Boolean)

Retourne la position de la première position modifiable non assignée entre les positions spécifiées à l'aide du sens de la recherche spécifié.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetOperationResultFromHint(MaskedTextResultHint)

Détermine si le MaskedTextResultHint spécifié dénote un succès ou un échec.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
InsertAt(Char, Int32)

Insère le caractère spécifié à la position spécifiée dans la chaîne mise en forme.

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Insère le caractère spécifié à la position spécifiée dans la chaîne mise en forme et retourne 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.

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 et retourne la dernière position d'insertion et l'état de l'opération.

IsAvailablePosition(Int32)

Détermine si la position spécifiée est disponible pour l'assignation.

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 Object actuel.

(Hérité de Object)
Remove()

Supprime le dernier caractère assigné de la chaîne mise en forme.

Remove(Int32, MaskedTextResultHint)

Supprime le dernier caractère assigné de la chaîne mise en forme, puis renvoie la position de suppression et les informations descriptives.

RemoveAt(Int32)

Supprime le caractère assigné à la position spécifiée de la chaîne mise en forme.

RemoveAt(Int32, Int32)

Supprime les caractères assignés entre les positions spécifiées de la chaîne mise en forme.

RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)

Supprime les caractères assignés entre les positions spécifiées de la chaîne mise en forme, puis renvoie la position de suppression et les informations descriptives.

Replace(Char, Int32)

Remplace un caractère unique au niveau ou au-delà de la position spécifiée par la valeur de caractère spécifiée.

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

Remplace un caractère unique entre le début spécifié et les positions de fin par la valeur de caractère spécifiée, puis renvoie la position de suppression et les informations descriptives.

Replace(Char, Int32, Int32, MaskedTextResultHint)

Remplace un caractère unique au niveau de ou au-delà de la position spécifiée par la valeur de caractère spécifiée, puis renvoie la position de suppression et les informations descriptives.

Replace(String, Int32)

Remplace une plage de caractères modifiables en commençant à la position spécifiée par la chaîne 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 renvoie la position de suppression et les informations descriptives.

Replace(String, Int32, Int32, MaskedTextResultHint)

Remplace une plage de caractères modifiables en commençant à la position spécifiée par la chaîne spécifiée, puis renvoie 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.

Set(String, Int32, MaskedTextResultHint)

Définit la chaîne mise en forme sur la chaîne d'entrée spécifiée, puis renvoie la position de suppression et les informations descriptives.

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ère assignées.

ToString(Boolean)

Retourne la chaîne mise en forme en incluant éventuellement les caractères de mot de passe.

ToString(Boolean, Boolean)

Retourne la chaîne mise en forme en incluant éventuellement des caractères littéraux et d'invite.

ToString(Boolean, Boolean, Boolean, Int32, Int32)

Retourne une sous-chaîne de la chaîne mise en forme et inclut éventuellement des caractères littéraux, d'invite et de mot de passe.

ToString(Boolean, Boolean, Int32, Int32)

Retourne une sous-chaîne de la chaîne mise en forme et inclut éventuellement des caractères littéraux et d'invite.

ToString(Boolean, Int32, Int32)

Retourne une sous-chaîne de la chaîne mise en forme et inclut éventuellement des 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 correctement à la position spécifiée.

VerifyEscapeChar(Char, Int32)

Teste si le caractère spécifié fait l'objet d'un échappement à la position spécifiée.

VerifyString(String)

Teste si la définition de la chaîne spécifiée est correcte.

VerifyString(String, Int32, MaskedTextResultHint)

Teste si la définition de la chaîne spécifiée est correcte, puis génère les informations descriptives et de position.

S’applique à

Voir aussi