Condividi tramite

MaskedTextBox.Mask Proprietà

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Origine:
MaskedTextBox.cs
Origine:
MaskedTextBox.cs
Origine:
MaskedTextBox.cs
Origine:
MaskedTextBox.cs
Origine:
MaskedTextBox.cs

Ottiene o imposta la maschera di input da utilizzare in fase di esecuzione.

public:
 property System::String ^ Mask { System::String ^ get(); void set(System::String ^ value); };
public string Mask { get; set; }
member this.Mask : string with get, set
Public Property Mask As String

Valore della proprietà

String

Oggetto String che rappresenta la maschera corrente. Il valore predefinito è la stringa vuota che consente qualsiasi input.

Eccezioni

ArgumentException

La stringa fornita alla Mask proprietà non è una maschera valida. Le maschere non valide includono maschere contenenti caratteri non stampabili.

Commenti

Mask è la proprietà predefinita per la MaskedTextBox classe .

Mask deve essere una stringa composta da uno o più elementi di maschera, come illustrato nella tabella seguente. Il linguaggio di maschera utilizzato da MaskedTextBox è definito dall'oggetto associato MaskedTextProvider. Il provider standard specifica un linguaggio di mascheramento basato su quello usato dal controllo Modifica mascherata in Visual Basic 6.0 e deve essere molto familiare agli utenti che eseguono la migrazione da tale piattaforma.

Elemento di mascheramento Descrizione
0 Cifra, obbligatorio. Questo elemento accetterà qualsiasi singola cifra compresa tra 0 e 9.
9 Cifra o spazio, facoltativo.
# Cifra o spazio, facoltativo. Se questa posizione è vuota nella maschera, verrà eseguito il rendering come spazio nella Text proprietà . Sono consentiti segni più (+) e meno (-).
L Lettera, obbligatoria. Limita l'input alle lettere ASCII a-z e A-Z. Questo elemento mask equivale a [a-zA-Z] nelle espressioni regolari.
? Lettera, facoltativa. Limita l'input alle lettere ASCII a-z e A-Z. Questo elemento mask equivale a [a-zA-Z]? nelle espressioni regolari.
& Carattere, obbligatorio. Se la AsciiOnly proprietà è impostata su true, questo elemento si comporta come l'elemento "L".
C Carattere, facoltativo. Qualsiasi carattere non di controllo. Se la AsciiOnly proprietà è impostata su true, questo elemento si comporta come l'elemento "?".
Un Alfanumerico, obbligatorio. Se la AsciiOnly proprietà è impostata su true, gli unici caratteri che accetteranno sono le lettere ASCII a-z e A-Z. Questo elemento mask si comporta come l'elemento "a".
a Alfanumerico, facoltativo. Se la AsciiOnly proprietà è impostata su true, gli unici caratteri che accetteranno sono le lettere ASCII a-z e A-Z. Questo elemento mask si comporta come l'elemento "A".
. Segnaposto decimale. Il carattere di visualizzazione effettivo utilizzato sarà il simbolo decimale appropriato per il provider di formato, come determinato dalla proprietà del FormatProvider controllo.
, Segnaposto migliaia. Il carattere di visualizzazione effettivo utilizzato sarà il segnaposto migliaia appropriato per il provider di formato, come determinato dalla proprietà del FormatProvider controllo.
: Separatore dell'ora. Il carattere di visualizzazione effettivo utilizzato sarà il simbolo dell'ora appropriato per il provider di formato, come determinato dalla proprietà del FormatProvider controllo.
/ Separatore della data. Il carattere di visualizzazione effettivo utilizzato sarà il simbolo di data appropriato per il provider di formato, come determinato dalla proprietà del FormatProvider controllo.
$ Simbolo di valuta. Il carattere effettivo visualizzato sarà il simbolo di valuta appropriato per il provider di formato, come determinato dalla proprietà del FormatProvider controllo.
< Spostarsi verso il basso. Converte tutti i caratteri che seguono in lettere minuscole.
> Spostarsi verso l'alto. Converte tutti i caratteri che seguono in maiuscolo.
| Disabilitare un turno precedente verso l'alto o spostarsi verso il basso.
\ Fuga. Esegue l'escape di un carattere di maschera, trasformandolo in un carattere letterale. "\\" è la sequenza di escape per una barra rovesciata (backslash).
Tutti gli altri caratteri Valori letterali. Tutti gli elementi non maschera verranno visualizzati come se stessi all'interno di MaskedTextBox. I valori letterali occupano sempre una posizione statica nella maschera in fase di esecuzione e non possono essere spostati o eliminati dall'utente.

Se si modifica una maschera quando MaskedTextBox contiene già l'input utente filtrato da una maschera precedente, MaskedTextBox tenterà di eseguire la migrazione di tale input nella nuova definizione della maschera. Se ha esito negativo, cancella l'input esistente. L'assegnazione di una stringa di lunghezza zero perché la maschera manterrà tutti i dati esistenti nel controllo . Se usato con una maschera di lunghezza zero, MaskedTextBox si comporta come un controllo a riga singola TextBox .

I simboli decimali (.), millesimi (,), ora (:), data (/) e valuta ($) vengono visualizzati per impostazione predefinita come definito dalle impostazioni cultura dell'applicazione. È possibile forzarli a visualizzare i simboli per altre impostazioni culturali usando le FormatProvider proprietà.

L'inserimento di caratteri nella maschera in fase di esecuzione è controllato dalla InsertKeyMode proprietà . Gli utenti possono spostarsi attraverso la maschera usando i tasti freccia sinistra e destra o il cursore del mouse e possono ignorare le posizioni facoltative nella maschera immettendo uno spazio.

Importante

MaskedTextBox supporta tutti i caratteri Unicode tranne i surrogati e i caratteri combinati verticalmente.

Nella tabella seguente vengono illustrate le maschere di esempio.

Maschera Comportamento
00/00/0000 Data (giorno, mese numerico, anno) in formato data internazionale. Il carattere "/" è un separatore di data logico e apparirà all'utente come separatore di data appropriato per le impostazioni cultura correnti dell'applicazione.
00->L<LL-0000 Data (giorno, abbreviazione del mese e anno) in formato Stati Uniti in cui l'abbreviazione del mese di tre lettere viene visualizzata con una lettera maiuscola iniziale seguita da due lettere minuscole.
(999)-000-0000 Numero di telefono degli Stati Uniti, codice di area facoltativo. Se gli utenti non vogliono immettere i caratteri facoltativi, possono immettere spazi o posizionare il puntatore del mouse direttamente nella posizione nella maschera rappresentata dal primo 0.
$999,999.00 Valore di valuta compreso nell'intervallo compreso tra 0 e 999999. La valuta, il millesimo e i caratteri decimali verranno sostituiti in fase di esecuzione con i loro equivalenti specifici culturali.

Si applica a

Vedi anche