Condividi tramite


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.

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

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.

Si applica a

Vedi anche