MaskedTextProvider Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Origine:

MaskedTextProvider.cs

Rappresenta un servizio di analisi della maschera che può essere utilizzato da un numero qualsiasi di controlli che supportano la maschera, ad esempio 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 controllo MaskedTextBox contiene una maschera, composta da caratteri letterali e elementi di formattazione, su cui testa tutti gli input dell'utente. Anziché associare in modo permanente un motore di analisi della maschera specifico a MaskedTextBox, Windows Form lo fornisce come servizio separato, rappresentato dalla classe MaskedTextProvider, che definisce la sintassi del linguaggio di maschera descritto nella documentazione per la proprietà Mask.

Molti dei membri della classe MaskedTextBox fanno riferimento all'implementazione di membri denominati in modo analogo del MaskedTextProviderassociato. Ad esempio, la proprietà MaskedTextBox.PromptChar della classe MaskedTextBox fa riferimento a tutti gli accessi alla PromptChar della classe MaskedTextProvider.

Il motore di analisi delle maschere utilizzato da MaskedTextProvider viene modellato dopo il controllo Mascherato Modifica incluso in Microsoft Visual Basic versione 6. Il linguaggio di maschera è descritto nella documentazione relativa alla proprietà Mask.

Le tre stringhe distinte seguenti sono coinvolte nella classe MaskedTextProvider.

Nome stringa	Descrizione
Carattere o stringa di input	Rappresenta i caratteri utilizzati come input a cui viene applicata la maschera. In realtà, la stringa di input può essere costituita da più operazioni di input, tra cui Add, Replace, InsertAte Remove. Pertanto, non è possibile accedere direttamente alla stringa di input. Tuttavia, gli aspetti della gestione delle stringhe di input sono disponibili anche se le proprietà AllowPromptAsInput e AsciiOnly, ResetOnPrompte ResetOnSpace.
Maschera	Rappresenta la maschera di formattazione di input utilizzata per trasformare la stringa di input nella stringa formattata. Questa stringa viene impostata nella MaskedTextProvider ed è accessibile principalmente tramite la proprietà Mask. Le caratteristiche della maschera sono disponibili anche tramite altri membri, ad esempio le proprietà Length, PasswordChare PromptChar.
Stringa formattata	Rappresenta la stringa risultante quando la maschera completa viene applicata alla stringa di input. È possibile eseguire query sulla stringa formattata con molti membri della classe, tra cui Item[], Length, LastAssignedPosition, MaskFull, MaskCompleted, FindEditPositionFrome così via. Il valore completo della stringa formattata è disponibile dai metodi ToDisplayString e ToString.

Nota

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

Costruttori

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

Proprietà

AllowPromptAsInput	Ottiene un valore che indica se il carattere di richiesta deve essere considerato come un carattere di input valido o meno.
AsciiOnly	Ottiene un valore che indica se la maschera accetta caratteri esterni al set di caratteri ASCII.
AssignedEditPositionCount	Ottiene il numero di posizioni dei caratteri modificabili a cui è già stato assegnato un valore di input.
AvailableEditPositionCount	Ottiene il numero di 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 separatori localizzabili e dei segnaposto nella maschera di input.
DefaultPasswordChar	Ottiene il carattere password predefinito utilizzato per nascondere l'input dell'utente.
EditPositionCount	Ottiene il numero di posizioni modificabili nella stringa formattata.
EditPositions	Ottiene un enumeratore appena creato per le posizioni modificabili nella stringa formattata.
IncludeLiterals	Ottiene o imposta un valore che indica se i caratteri letterali nella maschera di input devono essere inclusi nella stringa formattata.
IncludePrompt	Ottiene o imposta un valore che indica se PromptChar viene utilizzato per rappresentare l'assenza di input dell'utente durante la visualizzazione della stringa formattata.
InvalidIndex	Ottiene il limite superiore dell'intervallo di indici non validi.
IsPassword	Ottiene o imposta un valore che determina se la protezione password deve essere applicata alla stringa formattata.
Item[Int32]	Ottiene l'elemento in corrispondenza della posizione specificata nella stringa formattata.
LastAssignedPosition	Ottiene l'indice nella maschera del carattere di input più a destra assegnato alla maschera.
Length	Ottiene la lunghezza della maschera, assente qualsiasi carattere modificatore di maschera.
Mask	Ottiene la maschera di input.
MaskCompleted	Ottiene un valore che indica se tutti gli input obbligatori sono stati immessi nella stringa formattata.
MaskFull	Ottiene un valore che indica se tutti gli input obbligatori e facoltativi sono stati immessi nella stringa formattata.
PasswordChar	Ottiene o imposta il carattere da sostituire con i caratteri di input effettivi.
PromptChar	Ottiene o imposta il carattere utilizzato per rappresentare l'assenza di input 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 corrispondente al carattere di richiesta.
ResetOnSpace	Ottiene o imposta un valore che determina la modalità di gestione di un carattere di input dello spazio.
SkipLiterals	Ottiene o imposta un valore che indica se le posizioni dei caratteri letterali nella maschera possono essere sovrascritte dagli stessi valori.

Metodi

Add(Char, Int32, MaskedTextResultHint)	Aggiunge il carattere di input specificato alla fine della stringa formattata e quindi restituisce informazioni descrittive e sulla posizione.
Add(Char)	Aggiunge il carattere di input specificato alla fine della stringa formattata.
Add(String, Int32, MaskedTextResultHint)	Aggiunge i caratteri nella stringa di input specificata alla fine della stringa formattata e quindi restituisce informazioni descrittive e sulla posizione.
Add(String)	Aggiunge i caratteri nella stringa di input specificata alla fine della stringa formattata.
Clear()	Cancella tutti i caratteri di input modificabili dalla stringa formattata, sostituendoli con i caratteri di richiesta.
Clear(MaskedTextResultHint)	Cancella tutti i caratteri di input modificabili dalla stringa formattata, sostituendoli con i caratteri di richiesta e quindi restituisce informazioni descrittive.
Clone()	Crea una copia del MaskedTextProvidercorrente.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindAssignedEditPositionFrom(Int32, Boolean)	Restituisce la posizione della prima posizione modificabile assegnata dopo la posizione specificata utilizzando la direzione di ricerca specificata.
FindAssignedEditPositionInRange(Int32, Int32, Boolean)	Restituisce la posizione della prima posizione modificabile assegnata tra le posizioni specificate utilizzando la direzione di ricerca specificata.
FindEditPositionFrom(Int32, Boolean)	Restituisce la posizione della prima posizione modificabile dopo la posizione specificata utilizzando la direzione di ricerca specificata.
FindEditPositionInRange(Int32, Int32, Boolean)	Restituisce la posizione della prima posizione modificabile tra le posizioni specificate utilizzando la direzione di ricerca specificata.
FindNonEditPositionFrom(Int32, Boolean)	Restituisce la posizione della prima posizione non modificabile dopo la posizione specificata utilizzando la direzione di ricerca specificata.
FindNonEditPositionInRange(Int32, Int32, Boolean)	Restituisce la posizione della prima posizione non modificabile tra le posizioni specificate utilizzando la direzione di ricerca specificata.
FindUnassignedEditPositionFrom(Int32, Boolean)	Restituisce la posizione della prima posizione modificabile non assegnata dopo la posizione specificata utilizzando la direzione di ricerca specificata.
FindUnassignedEditPositionInRange(Int32, Int32, Boolean)	Restituisce la posizione della prima posizione modificabile non assegnata tra le posizioni specificate utilizzando la direzione di ricerca specificata.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetOperationResultFromHint(MaskedTextResultHint)	Determina se il MaskedTextResultHint specificato indica l'esito positivo o negativo.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	Inserisce il carattere specificato nella posizione specificata all'interno della stringa formattata, restituendo l'ultima posizione di inserimento e lo stato dell'operazione.
InsertAt(Char, Int32)	Inserisce il carattere specificato nella posizione specificata all'interno della stringa formattata.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Inserisce la stringa specificata in una posizione specificata all'interno della stringa formattata, restituendo l'ultima posizione di inserimento e lo stato dell'operazione.
InsertAt(String, Int32)	Inserisce la stringa specificata in una posizione specificata all'interno della stringa formattata.
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 di maschera valido.
IsValidPasswordChar(Char)	Determina se il carattere specificato è un carattere di password valido.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
Remove()	Rimuove l'ultimo carattere assegnato dalla stringa formattata.
Remove(Int32, MaskedTextResultHint)	Rimuove l'ultimo carattere assegnato dalla stringa formattata e quindi restituisce la posizione di rimozione e le informazioni descrittive.
RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)	Rimuove i caratteri assegnati tra le posizioni specificate dalla stringa formattata e quindi restituisce la posizione di rimozione e le informazioni descrittive.
RemoveAt(Int32, Int32)	Rimuove i caratteri assegnati tra le posizioni specificate dalla stringa formattata.
RemoveAt(Int32)	Rimuove il carattere assegnato nella posizione specificata dalla stringa formattata.
Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)	Sostituisce un singolo carattere tra le posizioni iniziali e finali specificate con il valore di carattere specificato e quindi restituisce la posizione di rimozione e le informazioni descrittive.
Replace(Char, Int32, Int32, MaskedTextResultHint)	Sostituisce un singolo carattere in corrispondenza o oltre la posizione specificata con il valore di carattere specificato e quindi restituisce la posizione di rimozione e le informazioni descrittive.
Replace(Char, Int32)	Sostituisce un singolo carattere in corrispondenza o oltre la posizione specificata con il valore di carattere specificato.
Replace(String, Int32, Int32, Int32, MaskedTextResultHint)	Sostituisce un intervallo di caratteri modificabili tra le posizioni iniziali e finali specificate con la stringa specificata e quindi restituisce la posizione di rimozione e le informazioni descrittive.
Replace(String, Int32, Int32, MaskedTextResultHint)	Sostituisce un intervallo di caratteri modificabili a partire dalla posizione specificata con la stringa specificata e quindi restituisce la posizione di rimozione e le informazioni descrittive.
Replace(String, Int32)	Sostituisce un intervallo di caratteri modificabili a partire dalla posizione specificata con la stringa specificata.
Set(String, Int32, MaskedTextResultHint)	Imposta la stringa formattata sulla stringa di input specificata e quindi restituisce la posizione di rimozione e le informazioni descrittive.
Set(String)	Imposta la stringa formattata sulla stringa di input specificata.
ToDisplayString()	Restituisce la stringa formattata in un formato visualizzabile.
ToString()	Restituisce la stringa formattata che include tutti i valori di carattere assegnati.
ToString(Boolean, Boolean, Boolean, Int32, Int32)	Restituisce una sottostringa della stringa formattata, facoltativamente inclusi i caratteri prompt, letterale e password.
ToString(Boolean, Boolean, Int32, Int32)	Restituisce una sottostringa della stringa formattata, facoltativamente inclusi i caratteri prompt e letterali.
ToString(Boolean, Boolean)	Restituisce la stringa formattata, facoltativamente inclusi i caratteri prompt e letterali.
ToString(Boolean, Int32, Int32)	Restituisce una sottostringa della stringa formattata, facoltativamente inclusi i caratteri della password.
ToString(Boolean)	Restituisce la stringa formattata, facoltativamente inclusi i caratteri della password.
ToString(Int32, Int32)	Restituisce una sottostringa della stringa formattata.
VerifyChar(Char, Int32, MaskedTextResultHint)	Verifica se il carattere specificato può essere impostato correttamente nella posizione specificata.
VerifyEscapeChar(Char, Int32)	Verifica se il carattere specificato verrebbe preceduto da un carattere di escape nella posizione specificata.
VerifyString(String, Int32, MaskedTextResultHint)	Verifica se la stringa specificata può essere impostata correttamente e quindi restituisce informazioni descrittive e sulla posizione.
VerifyString(String)	Verifica se la stringa specificata può essere impostata correttamente.

Vedi anche

• MaskedTextBox
• MaskedTextProvider
• Mask