MaskedTextProvider Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Source:

MaskedTextProvider.cs

Rappresenta un servizio di analisi mediante maschera utilizzabile da tutti i controlli che supportano l'utilizzo delle maschere, come il controllo MaskedTextBox.

public ref class MaskedTextProvider : ICloneable

public class MaskedTextProvider : ICloneable

type MaskedTextProvider = class
    interface ICloneable

Public Class MaskedTextProvider
Implements ICloneable

Ereditarietà

Object

MaskedTextProvider

Implementazioni

ICloneable

Commenti

Il MaskedTextBox controllo contiene una maschera, composta da caratteri letterali e elementi di formattazione, che testa tutti gli input dell'utente su. Anziché associare definitivamente un motore di analisi maschera specifico a MaskedTextBox, Windows Forms fornisce come servizio separato, rappresentato dalla MaskedTextProvider classe, che definisce la sintassi del linguaggio di maschera descritta nella documentazione per la Mask proprietà.

Molti dei membri della MaskedTextBox classe fanno riferimento alla relativa implementazione ai membri denominati in modo simile dell'oggetto associato MaskedTextProvider. Ad esempio, la MaskedTextBox.PromptChar proprietà della MaskedTextBox classe fa riferimento a tutti l'accesso PromptCharMaskedTextProvider alla classe.

Il motore di analisi maschera usato da MaskedTextProvider viene modellato dopo il controllo Modifica mascherata incluso in Microsoft Visual Basic versione 6. Il linguaggio di maschera è descritto nella documentazione per la Mask proprietà.

Le tre stringhe distinte seguenti sono coinvolte nella MaskedTextProvider classe.

Nome della stringa	Descrizione
Carattere di input o stringa	Rappresenta i caratteri usati come input a cui viene applicata la maschera. In realtà, la stringa di input può essere composta da più operazioni di input, tra cui Add, ReplaceInsertAt, e Remove. Pertanto, la stringa di input non può essere accessibile direttamente. Tuttavia, gli aspetti della gestione delle stringhe di input sono disponibili anche se le AllowPromptAsInput proprietà e , e ResetOnPromptAsciiOnlyResetOnSpace .
Mask	Rappresenta la maschera di formattazione dell'input usata per trasformare la stringa di input nella stringa formattata. Questa stringa è impostata nell'oggetto e a cui è stato eseguito l'accesso MaskedTextProvider principalmente anche se la Mask proprietà. Le caratteristiche della maschera sono disponibili anche tramite altri membri, ad esempio le Lengthproprietà , PasswordChare PromptChar .
Stringa formattata	Rappresenta la stringa che restituisce quando la maschera completa viene applicata alla stringa di input. La stringa formattata può essere eseguita una query con molti membri della classe, tra cui Item[], LastAssignedPositionMaskCompletedLengthMaskFull, FindEditPositionFrom, e così via. Il valore completo della stringa formattata è disponibile dai ToDisplayString metodi e ToString .

Nota

La stringa di input può rappresentare l'input utente diretto, come nel caso di MaskedTextBox, o può essere generato da altri processi non direttamente associati alle operazioni di input/output dell'utente.

Costruttori

MaskedTextProvider(String)	Inizializza una nuova istanza della classe MaskedTextProvider mediante la maschera specificata.
MaskedTextProvider(String, Boolean)	Inizializza una nuova istanza della classe MaskedTextProvider utilizzando la maschera e il valore di restrizione ASCII specificati.
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.
MaskedTextProvider(String, CultureInfo)	Inizializza una nuova istanza della classe MaskedTextProvider mediante la maschera e le impostazioni cultura specificate.
MaskedTextProvider(String, CultureInfo, Boolean)	Inizializza una nuova istanza della classe MaskedTextProvider utilizzando la maschera, le impostazioni cultura e il valore di restrizione ASCII specificati.
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.
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.

Proprietà

AllowPromptAsInput	Ottiene un valore che indica se il carattere di richiesta può essere utilizzato come carattere di input.
AsciiOnly	Ottiene un valore che indica se la maschera accetta caratteri non appartenenti al set di caratteri ASCII.
AssignedEditPositionCount	Ottiene il numero delle posizioni dei caratteri modificabili a cui è già stato assegnato un valore di input.
AvailableEditPositionCount	Ottiene il numero delle posizioni dei caratteri modificabili nella maschera di input a cui non è ancora stato assegnato un valore di input.
Culture	Ottiene le impostazioni cultura che determinano il valore dei segnaposti e dei separatori localizzabili nella maschera di input.
DefaultPasswordChar	Ottiene il carattere della password predefinito utilizzato per nascondere l'input dell'utente.
EditPositionCount	Ottiene il numero di posizioni modificabili nella stringa formattata.
EditPositions	Ottiene l'enumeratore appena creato per le posizioni modificabili della stringa formattata.
IncludeLiterals	Ottiene o imposta un valore che indica se è possibile includere nella stringa formattata i caratteri letterali della maschera di input.
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.
InvalidIndex	Ottiene il limite superiore dell'intervallo degli indici non validi.
IsPassword	Ottiene o imposta un valore che determina se applicare la protezione tramite password alla stringa formattata.
Item[Int32]	Ottiene l'elemento situato nella posizione specificata della stringa formattata.
LastAssignedPosition	Ottiene l'indice nella maschera del carattere di input all'estrema destra assegnato alla maschera.
Length	Ottiene la lunghezza della maschera, senza i caratteri modificatori della maschera.
Mask	Ottiene la maschera di input.
MaskCompleted	Ottiene un valore che indica se nella stringa formattata sono stati inseriti tutti gli input obbligatori.
MaskFull	Ottiene un valore che indica se nella stringa formattata sono stati inseriti tutti gli input obbligatori e facoltativi.
PasswordChar	Ottiene o imposta il carattere da sostituire ai caratteri di input effettivi.
PromptChar	Ottiene o imposta il carattere utilizzato per rappresentare l'assenza di input dell'utente per tutte le posizioni di modifica disponibili.
ResetOnPrompt	Ottiene o imposta un valore che determina la modalità di gestione di un carattere di input che corrisponda al carattere di richiesta.
ResetOnSpace	Ottiene o imposta un valore che determina la modalità di gestione di un carattere di input di spaziatura.
SkipLiterals	Ottiene o imposta un valore che indica se è possibile sovrascrivere le posizioni dei caratteri letterali nella maschera con gli stessi valori.

Metodi

Add(Char)	Aggiunge il carattere di input specificato alla fine della stringa formattata.
Add(Char, Int32, MaskedTextResultHint)	Aggiunge il carattere di input specificato alla fine della stringa formattata, quindi genera informazioni sulla posizione e sulla descrizione.
Add(String)	Aggiunge i caratteri nella stringa di input specificata alla fine della stringa formattata.
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.
Clear()	Cancella dalla stringa formattata tutti i caratteri di input modificabili e li sostituisce con i caratteri di richiesta.
Clear(MaskedTextResultHint)	Cancella dalla stringa formattata tutti i caratteri di input modificabili e li sostituisce con i caratteri di richiesta, quindi genera informazioni descrittive.
Clone()	Crea una copia dell'oggetto MaskedTextProvider corrente.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindAssignedEditPositionFrom(Int32, Boolean)	Restituisce la prima posizione modificabile assegnata successiva a quella specificata utilizzando la direzione di ricerca indicata.
FindAssignedEditPositionInRange(Int32, Int32, Boolean)	Restituisce la prima posizione modificabile assegnata compresa tra quelle specificate utilizzando la direzione di ricerca indicata.
FindEditPositionFrom(Int32, Boolean)	Restituisce la posizione della prima posizione modificabile successiva a quella specificata utilizzando la direzione di ricerca indicata.
FindEditPositionInRange(Int32, Int32, Boolean)	Restituisce la prima posizione modificabile compresa tra quelle specificate utilizzando la direzione di ricerca indicata.
FindNonEditPositionFrom(Int32, Boolean)	Restituisce la prima posizione non modificabile successiva a quella specificata utilizzando la direzione di ricerca indicata.
FindNonEditPositionInRange(Int32, Int32, Boolean)	Restituisce la prima posizione non modificabile compresa tra quelle specificate utilizzando la direzione di ricerca indicata.
FindUnassignedEditPositionFrom(Int32, Boolean)	Restituisce la prima posizione modificabile non assegnata successiva a quella specificata utilizzando la direzione di ricerca indicata.
FindUnassignedEditPositionInRange(Int32, Int32, Boolean)	Restituisce la prima posizione modificabile non assegnata compresa tra quelle specificate utilizzando la direzione di ricerca indicata.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetOperationResultFromHint(MaskedTextResultHint)	Determina se l'oggetto MaskedTextResultHint specificato indica esito positivo o negativo.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InsertAt(Char, Int32)	Inserisce il carattere specificato nella posizione indicata della stringa formattata.
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.
InsertAt(String, Int32)	Inserisce la stringa specificata nella posizione indicata della stringa formattata.
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.
IsAvailablePosition(Int32)	Determina se la posizione specificata è disponibile per l'assegnazione.
IsEditPosition(Int32)	Determina se la posizione specificata è modificabile.
IsValidInputChar(Char)	Determina se il carattere specificato è un carattere di input valido.
IsValidMaskChar(Char)	Determina se il carattere specificato è un carattere della maschera valido.
IsValidPasswordChar(Char)	Determina se il carattere specificato è un carattere della password valido.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove()	Rimuove dalla stringa formattata l'ultimo carattere assegnato.
Remove(Int32, MaskedTextResultHint)	Rimuove dalla stringa formattata l'ultimo carattere assegnato, quindi genera informazioni sulla posizione di rimozione e sulla descrizione.
RemoveAt(Int32)	Rimuove il carattere assegnato dalla posizione indicata della stringa formattata.
RemoveAt(Int32, Int32)	Rimuove dalla stringa formattata tutti i caratteri assegnati compresi tra le posizioni specificate.
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.
Replace(Char, Int32)	Sostituisce un singolo carattere nella posizione corrispondente o in quelle successive a quella specificata con il valore del carattere fornito.
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.
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.
Replace(String, Int32)	Sostituisce un intervallo di caratteri modificabili a partire dalla posizione indicata con la stringa specificata.
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.
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.
Set(String)	Imposta la stringa formattata sulla stringa di input specificata.
Set(String, Int32, MaskedTextResultHint)	Imposta la stringa formattata sulla stringa di input specificata, quindi genera informazioni sulla posizione di rimozione e sulla descrizione.
ToDisplayString()	Restituisce la stringa formattata in formato visualizzabile.
ToString()	Restituisce la stringa formattata che include tutti i valori dei caratteri assegnati.
ToString(Boolean)	Restituisce la stringa formattata e include, facoltativamente, i caratteri della password.
ToString(Boolean, Boolean)	Restituisce la stringa formattata e include, facoltativamente, i caratteri di richiesta e letterali.
ToString(Boolean, Boolean, Boolean, Int32, Int32)	Restituisce una sottostringa della stringa formattata e include, facoltativamente, i caratteri di richiesta, letterali e della password.
ToString(Boolean, Boolean, Int32, Int32)	Restituisce una sottostringa della stringa formattata e include, facoltativamente, i caratteri di richiesta e letterali.
ToString(Boolean, Int32, Int32)	Restituisce una sottostringa della stringa formattata e, facoltativamente, i caratteri della password.
ToString(Int32, Int32)	Restituisce una sottostringa della stringa formattata.
VerifyChar(Char, Int32, MaskedTextResultHint)	Verifica se è possibile impostare il carattere specificato nella posizione indicata.
VerifyEscapeChar(Char, Int32)	Verifica se il carattere specificato nella posizione indicata viene sottoposto a escape.
VerifyString(String)	Verifica se è possibile impostare la stringa formattata.
VerifyString(String, Int32, MaskedTextResultHint)	Verifica se è possibile impostare la stringa specificata, quindi genera informazioni sulla posizione e sulla descrizione.

Vedi anche

• MaskedTextBox
• MaskedTextProvider
• Mask