MaskedTextProvider Classe

Definizione

Rappresenta un servizio di analisi mediante maschera utilizzabile da tutti i controlli che supportano l'utilizzo delle maschere, come il controllo MaskedTextBox.Represents a mask-parsing service that can be used by any number of controls that support masking, such as the MaskedTextBox control.

public ref class MaskedTextProvider : ICloneable
public class MaskedTextProvider : ICloneable
type MaskedTextProvider = class
    interface ICloneable
Public Class MaskedTextProvider
Implements ICloneable
Ereditarietà
MaskedTextProvider
Implementazioni

Commenti

Il controllo MaskedTextBox contiene una maschera, composta da caratteri letterali ed elementi di formattazione, che testa tutti gli input utente rispetto a.The MaskedTextBox control contains a mask, composed of literal characters and formatting elements, that it tests all user input against. Invece di associare in modo permanente un motore di analisi della maschera specifico con MaskedTextBox, Windows Forms lo fornisce come servizio separato, rappresentato dalla classe MaskedTextProvider, che definisce la sintassi del linguaggio di mascheramento descritto nella documentazione relativa alla proprietà Mask.Instead of permanently associating a specific mask-parsing engine with MaskedTextBox, Windows Forms provides it as a separate service, represented by the MaskedTextProvider class, which defines the syntax of the masking language discussed in the documentation for the Mask property.

Molti dei membri della classe MaskedTextBox fanno riferimento alla relativa implementazione a membri denominati in modo analogo della MaskedTextProviderassociata.Many of the members of the MaskedTextBox class refer their implementation to similarly named members of the associated MaskedTextProvider. Ad esempio, la proprietà MaskedTextBox.PromptChar della classe MaskedTextBox fa riferimento a tutti gli accessi al PromptChar della classe MaskedTextProvider.For example, the MaskedTextBox.PromptChar property of the MaskedTextBox class refers all access to the PromptChar of the MaskedTextProvider class.

Il motore di analisi della maschera usato da MaskedTextProvider viene modellato dopo il controllo di modifica mascherato incluso in Microsoft Visual Basic versione 6.The mask-parsing engine used by MaskedTextProvider is modeled after the Masked Edit control included in Microsoft Visual Basic version 6. Il linguaggio di maschera è descritto nella documentazione relativa alla proprietà Mask.Its masking language is described in the documentation for the Mask property.

Con la classe MaskedTextProvider sono incluse le tre stringhe distinte seguenti.The following three distinct strings are involved with the MaskedTextProvider class.

Nome stringaString name DescrizioneDescription
Stringa o carattere di inputInput character or string Rappresenta i caratteri utilizzati come input su cui viene applicata la maschera.Represents the characters used as input that the mask is applied against. In realtà, la stringa di input può essere costituita da più operazioni di input, tra cui Add, Replace, InsertAte Remove.In actuality, the input string may be composed of multiple input operations, including Add, Replace, InsertAt, and Remove. Pertanto, non è possibile accedere direttamente alla stringa di input.Therefore, the input string cannot be accessed directly. Tuttavia, gli aspetti della gestione delle stringhe di input sono disponibili anche se le proprietà AllowPromptAsInput e AsciiOnly, ResetOnPrompte ResetOnSpace.However, aspects of the input string handling are available though the AllowPromptAsInput and AsciiOnly, ResetOnPrompt, and ResetOnSpace properties.
MaskMask Rappresenta la maschera di formattazione dell'input utilizzata per trasformare la stringa di input nella stringa formattata.Represents the input formatting mask used to transform the input string into the formatted string. Questa stringa viene impostata nel MaskedTextProvider e a cui si accede principalmente tramite la proprietà Mask.This string is set in the MaskedTextProvider and accessed primarily though the Mask property. Le caratteristiche della maschera sono disponibili anche tramite altri membri, ad esempio le proprietà Length, PasswordChare PromptChar.Characteristics of the mask are also available through other members, such as the Length, PasswordChar, and PromptChar properties.
Stringa formattataFormatted string Rappresenta la stringa risultante quando viene applicata la maschera completa alla stringa di input.Represents the string that results when the full mask is applied to the input string. La stringa formattata può essere sottoposta a query con molti membri della classe, tra cui Item[], Length, LastAssignedPosition, MaskFull, MaskCompleted, FindEditPositionFrome così via.The formatted string can be queried with many members of the class, including Item[], Length, LastAssignedPosition, MaskFull, MaskCompleted, FindEditPositionFrom, and so on. Il valore completo della stringa formattata è disponibile nei metodi ToDisplayString e ToString.The full value of the formatted string is available from the ToDisplayString and ToString methods.

Nota

La stringa di input può rappresentare un input utente diretto, come nel caso del MaskedTextBox, oppure può essere generata da altri processi non associati direttamente alle operazioni di input/output dell'utente.The input string may represent direct user input, as in the case of the MaskedTextBox, or may be generated by other processes not directly associated with user input/output operations.

Costruttori

MaskedTextProvider(String)

Inizializza una nuova istanza della classe MaskedTextProvider mediante la maschera specificata.Initializes a new instance of the MaskedTextProvider class using the specified mask.

MaskedTextProvider(String, Boolean)

Inizializza una nuova istanza della classe MaskedTextProvider utilizzando la maschera e il valore di restrizione ASCII specificati.Initializes a new instance of the MaskedTextProvider class using the specified mask and ASCII restriction value.

MaskedTextProvider(String, Char, Boolean)

Inizializza una nuova istanza della classe MaskedTextProvider utilizzando la maschera, il carattere della password e il valore di utilizzo della richiesta specificati.Initializes a new instance of the MaskedTextProvider class using the specified mask, password character, and prompt usage value.

MaskedTextProvider(String, CultureInfo)

Inizializza una nuova istanza della classe MaskedTextProvider mediante la maschera e le impostazioni cultura specificate.Initializes a new instance of the MaskedTextProvider class using the specified mask and culture.

MaskedTextProvider(String, CultureInfo, Boolean)

Inizializza una nuova istanza della classe MaskedTextProvider utilizzando la maschera, le impostazioni cultura e il valore di restrizione ASCII specificati.Initializes a new instance of the MaskedTextProvider class using the specified mask, culture, and ASCII restriction value.

MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean)

Inizializza una nuova istanza della classe MaskedTextProvider utilizzando la maschera, le impostazioni cultura, il valore di utilizzo della richiesta, il carattere di richiesta, il carattere della password e il valore di restrizione ASCII specificati.Initializes a new instance of the MaskedTextProvider class using the specified mask, culture, prompt usage value, prompt character, password character, and ASCII restriction value.

MaskedTextProvider(String, CultureInfo, Char, Boolean)

Inizializza una nuova istanza della classe MaskedTextProvider utilizzando la maschera, le impostazioni cultura, il carattere della password e il valore di utilizzo della richiesta specificati.Initializes a new instance of the MaskedTextProvider class using the specified mask, culture, password character, and prompt usage value.

Proprietà

AllowPromptAsInput

Ottiene un valore che indica se il carattere di richiesta può essere utilizzato come carattere di input.Gets a value indicating whether the prompt character should be treated as a valid input character or not.

AsciiOnly

Ottiene un valore che indica se la maschera accetta caratteri non appartenenti al set di caratteri ASCII.Gets a value indicating whether the mask accepts characters outside of the ASCII character set.

AssignedEditPositionCount

Ottiene il numero delle posizioni dei caratteri modificabili a cui è già stato assegnato un valore di input.Gets the number of editable character positions that have already been successfully assigned an input value.

AvailableEditPositionCount

Ottiene il numero delle posizioni dei caratteri modificabili nella maschera di input a cui non è ancora stato assegnato un valore di input.Gets the number of editable character positions in the input mask that have not yet been assigned an input value.

Culture

Ottiene le impostazioni cultura che determinano il valore dei segnaposti e dei separatori localizzabili nella maschera di input.Gets the culture that determines the value of the localizable separators and placeholders in the input mask.

DefaultPasswordChar

Ottiene il carattere della password predefinito utilizzato per nascondere l'input dell'utente.Gets the default password character used obscure user input.

EditPositionCount

Ottiene il numero di posizioni modificabili nella stringa formattata.Gets the number of editable positions in the formatted string.

EditPositions

Ottiene l'enumeratore appena creato per le posizioni modificabili della stringa formattata.Gets a newly created enumerator for the editable positions in the formatted string.

IncludeLiterals

Ottiene o imposta un valore che indica se è possibile includere nella stringa formattata i caratteri letterali della maschera di input.Gets or sets a value that indicates whether literal characters in the input mask should be included in the formatted string.

IncludePrompt

Ottiene o imposta un valore che indica se viene utilizzata la proprietà PromptChar per rappresentare l'assenza dell'input dell'utente nella visualizzazione della stringa formattata.Gets or sets a value indicating whether PromptChar is used to represent the absence of user input when displaying the formatted string.

InvalidIndex

Ottiene il limite superiore dell'intervallo degli indici non validi.Gets the upper bound of the range of invalid indexes.

IsPassword

Ottiene o imposta un valore che determina se applicare la protezione tramite password alla stringa formattata.Gets or sets a value that determines whether password protection should be applied to the formatted string.

Item[Int32]

Ottiene l'elemento situato nella posizione specificata della stringa formattata.Gets the element at the specified position in the formatted string.

LastAssignedPosition

Ottiene l'indice nella maschera del carattere di input all'estrema destra assegnato alla maschera.Gets the index in the mask of the rightmost input character that has been assigned to the mask.

Length

Ottiene la lunghezza della maschera, senza i caratteri modificatori della maschera.Gets the length of the mask, absent any mask modifier characters.

Mask

Ottiene la maschera di input.Gets the input mask.

MaskCompleted

Ottiene un valore che indica se nella stringa formattata sono stati inseriti tutti gli input obbligatori.Gets a value indicating whether all required inputs have been entered into the formatted string.

MaskFull

Ottiene un valore che indica se nella stringa formattata sono stati inseriti tutti gli input obbligatori e facoltativi.Gets a value indicating whether all required and optional inputs have been entered into the formatted string.

PasswordChar

Ottiene o imposta il carattere da sostituire ai caratteri di input effettivi.Gets or sets the character to be substituted for the actual input characters.

PromptChar

Ottiene o imposta il carattere utilizzato per rappresentare l'assenza di input dell'utente per tutte le posizioni di modifica disponibili.Gets or sets the character used to represent the absence of user input for all available edit positions.

ResetOnPrompt

Ottiene o imposta un valore che determina la modalità di gestione di un carattere di input che corrisponda al carattere di richiesta.Gets or sets a value that determines how an input character that matches the prompt character should be handled.

ResetOnSpace

Ottiene o imposta un valore che determina la modalità di gestione di un carattere di input di spaziatura.Gets or sets a value that determines how a space input character should be handled.

SkipLiterals

Ottiene o imposta un valore che indica se è possibile sovrascrivere le posizioni dei caratteri letterali nella maschera con gli stessi valori.Gets or sets a value indicating whether literal character positions in the mask can be overwritten by their same values.

Metodi

Add(Char)

Aggiunge il carattere di input specificato alla fine della stringa formattata.Adds the specified input character to the end of the formatted string.

Add(Char, Int32, MaskedTextResultHint)

Aggiunge il carattere di input specificato alla fine della stringa formattata, quindi genera informazioni sulla posizione e sulla descrizione.Adds the specified input character to the end of the formatted string, and then outputs position and descriptive information.

Add(String)

Aggiunge i caratteri nella stringa di input specificata alla fine della stringa formattata.Adds the characters in the specified input string to the end of the formatted string.

Add(String, Int32, MaskedTextResultHint)

Aggiunge i caratteri nella stringa di input specificata alla fine della stringa formattata, quindi genera informazioni sulla posizione e sulla descrizione.Adds the characters in the specified input string to the end of the formatted string, and then outputs position and descriptive information.

Clear()

Cancella dalla stringa formattata tutti i caratteri di input modificabili e li sostituisce con i caratteri di richiesta.Clears all the editable input characters from the formatted string, replacing them with prompt characters.

Clear(MaskedTextResultHint)

Cancella dalla stringa formattata tutti i caratteri di input modificabili e li sostituisce con i caratteri di richiesta, quindi genera informazioni descrittive.Clears all the editable input characters from the formatted string, replacing them with prompt characters, and then outputs descriptive information.

Clone()

Crea una copia dell'oggetto MaskedTextProvider corrente.Creates a copy of the current MaskedTextProvider.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
FindAssignedEditPositionFrom(Int32, Boolean)

Restituisce la prima posizione modificabile assegnata successiva a quella specificata utilizzando la direzione di ricerca indicata.Returns the position of the first assigned editable position after the specified position using the specified search direction.

FindAssignedEditPositionInRange(Int32, Int32, Boolean)

Restituisce la prima posizione modificabile assegnata compresa tra quelle specificate utilizzando la direzione di ricerca indicata.Returns the position of the first assigned editable position between the specified positions using the specified search direction.

FindEditPositionFrom(Int32, Boolean)

Restituisce la posizione della prima posizione modificabile successiva a quella specificata utilizzando la direzione di ricerca indicata.Returns the position of the first editable position after the specified position using the specified search direction.

FindEditPositionInRange(Int32, Int32, Boolean)

Restituisce la prima posizione modificabile compresa tra quelle specificate utilizzando la direzione di ricerca indicata.Returns the position of the first editable position between the specified positions using the specified search direction.

FindNonEditPositionFrom(Int32, Boolean)

Restituisce la prima posizione non modificabile successiva a quella specificata utilizzando la direzione di ricerca indicata.Returns the position of the first non-editable position after the specified position using the specified search direction.

FindNonEditPositionInRange(Int32, Int32, Boolean)

Restituisce la prima posizione non modificabile compresa tra quelle specificate utilizzando la direzione di ricerca indicata.Returns the position of the first non-editable position between the specified positions using the specified search direction.

FindUnassignedEditPositionFrom(Int32, Boolean)

Restituisce la prima posizione modificabile non assegnata successiva a quella specificata utilizzando la direzione di ricerca indicata.Returns the position of the first unassigned editable position after the specified position using the specified search direction.

FindUnassignedEditPositionInRange(Int32, Int32, Boolean)

Restituisce la prima posizione modificabile non assegnata compresa tra quelle specificate utilizzando la direzione di ricerca indicata.Returns the position of the first unassigned editable position between the specified positions using the specified search direction.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetOperationResultFromHint(MaskedTextResultHint)

Determina se l'oggetto MaskedTextResultHint specificato indica esito positivo o negativo.Determines whether the specified MaskedTextResultHint denotes success or failure.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InsertAt(Char, Int32)

Inserisce il carattere specificato nella posizione indicata della stringa formattata.Inserts the specified character at the specified position within the formatted string.

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Inserisce il carattere specificato nella posizione indicata della stringa formattata, restituendo l'ultima posizione di inserimento e lo stato dell'operazione.Inserts the specified character at the specified position within the formatted string, returning the last insertion position and the status of the operation.

InsertAt(String, Int32)

Inserisce la stringa specificata nella posizione indicata della stringa formattata.Inserts the specified string at a specified position within the formatted string.

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Inserisce la stringa specificata nella posizione indicata della stringa formattata, restituendo l'ultima posizione di inserimento e lo stato dell'operazione.Inserts the specified string at a specified position within the formatted string, returning the last insertion position and the status of the operation.

IsAvailablePosition(Int32)

Determina se la posizione specificata è disponibile per l'assegnazione.Determines whether the specified position is available for assignment.

IsEditPosition(Int32)

Determina se la posizione specificata è modificabile.Determines whether the specified position is editable.

IsValidInputChar(Char)

Determina se il carattere specificato è un carattere di input valido.Determines whether the specified character is a valid input character.

IsValidMaskChar(Char)

Determina se il carattere specificato è un carattere della maschera valido.Determines whether the specified character is a valid mask character.

IsValidPasswordChar(Char)

Determina se il carattere specificato è un carattere della password valido.Determines whether the specified character is a valid password character.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
Remove()

Rimuove dalla stringa formattata l'ultimo carattere assegnato.Removes the last assigned character from the formatted string.

Remove(Int32, MaskedTextResultHint)

Rimuove dalla stringa formattata l'ultimo carattere assegnato, quindi genera informazioni sulla posizione di rimozione e sulla descrizione.Removes the last assigned character from the formatted string, and then outputs the removal position and descriptive information.

RemoveAt(Int32)

Rimuove il carattere assegnato dalla posizione indicata della stringa formattata.Removes the assigned character at the specified position from the formatted string.

RemoveAt(Int32, Int32)

Rimuove dalla stringa formattata tutti i caratteri assegnati compresi tra le posizioni specificate.Removes the assigned characters between the specified positions from the formatted string.

RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)

Rimuove dalla stringa formattata i caratteri assegnati compresi tra le posizioni specificate, quindi genera informazioni sulla posizione di rimozione e sulla descrizione.Removes the assigned characters between the specified positions from the formatted string, and then outputs the removal position and descriptive information.

Replace(Char, Int32)

Sostituisce un singolo carattere nella posizione corrispondente o in quelle successive a quella specificata con il valore del carattere fornito.Replaces a single character at or beyond the specified position with the specified character value.

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

Sostituisce un singolo carattere compreso tra le posizioni iniziale e finale specificate con il valore del carattere fornito, quindi genera informazioni sulla posizione di rimozione e sulla descrizione.Replaces a single character between the specified starting and ending positions with the specified character value, and then outputs the removal position and descriptive information.

Replace(Char, Int32, Int32, MaskedTextResultHint)

Sostituisce un singolo carattere nella posizione corrispondente o in quelle successive a quella specificata con il valore del carattere fornito, quindi genera informazioni sulla posizione di rimozione e sulla descrizione.Replaces a single character at or beyond the specified position with the specified character value, and then outputs the removal position and descriptive information.

Replace(String, Int32)

Sostituisce un intervallo di caratteri modificabili a partire dalla posizione indicata con la stringa specificata.Replaces a range of editable characters starting at the specified position with the specified string.

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

Sostituisce un intervallo di caratteri modificabili compresi tra le posizioni iniziale finale specificate, quindi genera informazioni sulla posizione di rimozione e sulla descrizione.Replaces a range of editable characters between the specified starting and ending positions with the specified string, and then outputs the removal position and descriptive information.

Replace(String, Int32, Int32, MaskedTextResultHint)

Sostituisce un intervallo di caratteri modificabili a partire dalla posizione indicata con la stringa specificata, quindi genera informazioni sulla posizione di rimozione e sulla descrizione.Replaces a range of editable characters starting at the specified position with the specified string, and then outputs the removal position and descriptive information.

Set(String)

Imposta la stringa formattata sulla stringa di input specificata.Sets the formatted string to the specified input string.

Set(String, Int32, MaskedTextResultHint)

Imposta la stringa formattata sulla stringa di input specificata, quindi genera informazioni sulla posizione di rimozione e sulla descrizione.Sets the formatted string to the specified input string, and then outputs the removal position and descriptive information.

ToDisplayString()

Restituisce la stringa formattata in formato visualizzabile.Returns the formatted string in a displayable form.

ToString()

Restituisce la stringa formattata che include tutti i valori dei caratteri assegnati.Returns the formatted string that includes all the assigned character values.

ToString(Boolean)

Restituisce la stringa formattata e include, facoltativamente, i caratteri della password.Returns the formatted string, optionally including password characters.

ToString(Boolean, Boolean)

Restituisce la stringa formattata e include, facoltativamente, i caratteri di richiesta e letterali.Returns the formatted string, optionally including prompt and literal characters.

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

Restituisce una sottostringa della stringa formattata e include, facoltativamente, i caratteri di richiesta, letterali e della password.Returns a substring of the formatted string, optionally including prompt, literal, and password characters.

ToString(Boolean, Boolean, Int32, Int32)

Restituisce una sottostringa della stringa formattata e include, facoltativamente, i caratteri di richiesta e letterali.Returns a substring of the formatted string, optionally including prompt and literal characters.

ToString(Boolean, Int32, Int32)

Restituisce una sottostringa della stringa formattata e, facoltativamente, i caratteri della password.Returns a substring of the formatted string, optionally including password characters.

ToString(Int32, Int32)

Restituisce una sottostringa della stringa formattata.Returns a substring of the formatted string.

VerifyChar(Char, Int32, MaskedTextResultHint)

Verifica se è possibile impostare il carattere specificato nella posizione indicata.Tests whether the specified character could be set successfully at the specified position.

VerifyEscapeChar(Char, Int32)

Verifica se il carattere specificato nella posizione indicata viene sottoposto a escape.Tests whether the specified character would be escaped at the specified position.

VerifyString(String)

Verifica se è possibile impostare la stringa formattata.Tests whether the specified string could be set successfully.

VerifyString(String, Int32, MaskedTextResultHint)

Verifica se è possibile impostare la stringa specificata, quindi genera informazioni sulla posizione e sulla descrizione.Tests whether the specified string could be set successfully, and then outputs position and descriptive information.

Si applica a

Vedi anche