MaskedTextBox.Mask Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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 è una stringa vuota in cui è possibile immettere qualsiasi carattere di input.

Eccezioni

ArgumentException

La stringa fornita alla proprietà Mask non è una maschera valida. Le maschere non valide comprendono quelle 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 mascheramento, 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 Masking Descrizione
0 Cifra, obbligatoria. 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 "?".
Una Alfanumerico, obbligatorio. Se la AsciiOnly proprietà è impostata su true, gli unici caratteri che accetterà 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 accetterà 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 lettere maiuscole.
| Disabilitare uno spostamento precedente verso l'alto o spostarsi verso il basso.
\ Fuga. Esegue l'escape di un carattere maschera, trasformandolo in un valore letterale. "\\" è la sequenza di escape per una barra rovesciata.
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 dell'utente filtrato in base a una maschera precedente, MaskedTextBox tenterà di eseguire la migrazione dell'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 TextBox singola.

I simboli decimali (.), millesimi (,), ora (:), data (/) e valuta ($) vengono visualizzati come definiti dalle impostazioni cultura dell'applicazione. È possibile forzarli a visualizzare i simboli per altre impostazioni cultura usando la 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 di direzione sinistro e destro o il cursore del mouse e possono ignorare le posizioni facoltative nella maschera immettendo uno spazio.

Importante

MaskedTextBox supporta tutti i caratteri Unicode, ad eccezione dei surrogati e dei caratteri combinati verticalmente.

Nella tabella seguente vengono illustrate le maschere di esempio.

Mask Comportamento
00/00/0000 Data (giorno, mese numerico, anno) in formato data internazionale. Il carattere "/" è un separatore di data logico e verrà visualizzato all'utente come separatore di data appropriato alle impostazioni cultura correnti dell'applicazione.
00->L<LL-0000 Data (giorno, abbreviazione del mese e anno) in formato Stati Uniti in cui viene visualizzata l'abbreviazione del mese di tre lettere con una lettera maiuscola iniziale seguita da due lettere minuscole.
(999)-000-0000 Stati Uniti numero di telefono, 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 da 0 a 999999. La valuta, il millesimo e i caratteri decimali verranno sostituiti in fase di esecuzione con gli equivalenti specifici delle impostazioni cultura.

Si applica a

Vedi anche