MaskedTextBox.Mask Eigenschap

Definitie

Naamruimte:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Bron:

MaskedTextBox.cs

Hiermee haalt u het invoermasker op of stelt u dit in voor gebruik tijdens runtime.

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

Waarde van eigenschap

String

Een String vertegenwoordiging van het huidige masker. De standaardwaarde is de lege tekenreeks die invoer toestaat.

Uitzonderingen

ArgumentException

De tekenreeks die aan de Mask eigenschap is opgegeven, is geen geldig masker. Ongeldige maskers zijn maskers met niet-afdrukbare tekens.

Opmerkingen

Mask is de standaardeigenschap voor de MaskedTextBox klasse.

Mask moet een tekenreeks zijn die bestaat uit een of meer maskeringselementen, zoals wordt weergegeven in de volgende tabel. De maskeringstaal die wordt gebruikt, MaskedTextBox wordt gedefinieerd door de bijbehorende MaskedTextProvidertaal. De standaardprovider geeft een maskeringstaal op op basis van de taal die wordt gebruikt door het besturingselement Gemaskeerde bewerking in Visual Basic 6.0 en moet zeer bekend zijn voor gebruikers die vanaf dat platform migreren.

Maskeringselement	Beschrijving
0	Cijfer, vereist. Dit element accepteert één cijfer tussen 0 en 9.
9	Cijfer of spatie, optioneel.
#	Cijfer of spatie, optioneel. Als deze positie leeg is in het masker, wordt deze weergegeven als een spatie in de Text eigenschap. Plustekens (+) en mintekens (-) zijn toegestaan.
L	Letter, vereist. Beperkt de invoer tot de ASCII-letters a-z en A-Z. Dit maskerelement is gelijk aan [a-zA-Z] in reguliere expressies.
?	Letter, optioneel. Beperkt de invoer tot de ASCII-letters a-z en A-Z. Dit maskerelement is gelijk aan [a-zA-Z]? in reguliere expressies.
&	Teken, vereist. Als de AsciiOnly eigenschap is ingesteld op true, gedraagt dit element zich als het element L.
C	Teken, optioneel. Elk niet-besturingselementteken. Als de AsciiOnly eigenschap is ingesteld op true, gedraagt dit element zich als het element '?'.
A	Alfanumeriek, vereist. Als de AsciiOnly eigenschap is ingesteld op true, zijn de enige tekens die worden geaccepteerd de ASCII-letters a-z en A-Z. Dit maskerelement gedraagt zich als het 'a'-element.
a	Alfanumeriek, optioneel. Als de AsciiOnly eigenschap is ingesteld op true, zijn de enige tekens die worden geaccepteerd de ASCII-letters a-z en A-Z. Dit maskerelement gedraagt zich als het A-element.
.	Tijdelijke aanduiding voor decimalen. Het gebruikte weergaveteken is het decimale symbool dat geschikt is voor de notatieprovider, zoals wordt bepaald door de eigenschap van FormatProvider het besturingselement.
,	Tijdelijke aanduiding voor duizendtallen. Het werkelijke weergaveteken dat wordt gebruikt, is de tijdelijke aanduiding voor duizendtallen die geschikt zijn voor de indelingsprovider, zoals wordt bepaald door de eigenschap van FormatProvider het besturingselement.
:	Tijdscheidingsteken. Het werkelijke weergaveteken dat wordt gebruikt, is het tijdsymbool dat geschikt is voor de notatieprovider, zoals wordt bepaald door de eigenschap van FormatProvider het besturingselement.
/	Datumscheidingsteken. Het gebruikte weergaveteken is het datumsymbool dat geschikt is voor de notatieprovider, zoals wordt bepaald door de eigenschap van FormatProvider het besturingselement.
$	Valutasymbool. Het weergegeven teken is het valutasymbool dat geschikt is voor de notatieprovider, zoals wordt bepaald door de eigenschap van FormatProvider het besturingselement.
<	Schuif omlaag. Converteert alle tekens die volgen naar kleine letters.
>	Omhoog schuiven. Converteert alle tekens die volgen naar hoofdletters.
|	Schakel een vorige dienst omhoog of omlaag uit.
\	Ontsnappen. Escapet een maskerteken, waardoor het een letterlijke teken wordt. "\\" is de escape-sequentie voor een backslash.
Alle andere tekens	Letterlijke gegevens. Alle niet-maskerelementen zullen binnen MaskedTextBox als zichzelf verschijnen. Letterlijke gegevens hebben altijd een statische positie in het masker tijdens runtime en kunnen niet door de gebruiker worden verplaatst of verwijderd.

Als u een masker wijzigt wanneer MaskedTextBox gebruikersinvoer al is gefilterd op een vorig masker, MaskedTextBox probeert u die invoer te migreren naar de nieuwe maskerdefinitie. Als dit mislukt, wordt de bestaande invoer gewist. Als u een tekenreeks met lengte nul toewijst, blijven bestaande gegevens in het besturingselement behouden. Wanneer het wordt gebruikt met een masker met lengte nul, MaskedTextBox gedraagt zich als een besturingselement met één regel TextBox .

De decimale symbolen (.), duizendste (,), tijd (:), datum (/) en valutasymbolen ($) worden standaard weergegeven, zoals gedefinieerd in de cultuur van de toepassing. U kunt afdwingen dat symbolen voor een andere cultuur worden weergegeven met behulp van de FormatProvider eigenschap.

Het invoegen van tekens in het masker tijdens runtime wordt bepaald door de InsertKeyMode eigenschap. Gebruikers kunnen door het masker navigeren met behulp van de pijl-links en pijl-rechts of de muiscursor en kunnen optionele posities in het masker overslaan door een spatie in te voeren.

Important

MaskedTextBox ondersteunt alle Unicode-tekens, met uitzondering van surrogaten en verticaal gecombineerde tekens.

In de volgende tabel ziet u voorbeeldmaskers.

Masker	Gedrag
00/00/0000	Een datum (dag, numerieke maand, jaar) in internationale datumnotatie. Het teken '/' is een logisch datumscheidingsteken en wordt aan de gebruiker weergegeven als het datumscheidingsteken dat geschikt is voor de huidige cultuur van de toepassing.
00->L<LL-0000	Een datum (dag, maandafkorting en jaar) in de Amerikaanse datumnotatie waarin de afkorting van de maand met drie letters wordt weergegeven met een eerste hoofdletter, gevolgd door twee kleine letters.
(999)-000-0000	Telefoonnummer verenigde Staten, netnummer optioneel. Als gebruikers de optionele tekens niet willen invoeren, kunnen ze spaties invoeren of de muisaanwijzer rechtstreeks op de positie in het masker plaatsen dat wordt vertegenwoordigd door de eerste 0.
$999,999.00	Een valutawaarde in het bereik van 0 tot 999999. De valuta, duizendde en decimale tekens worden tijdens runtime vervangen door hun cultuurspecifieke equivalenten.

Zie ook

• Text
• MaskFull
• MaskCompleted
• MaskChanged
• MaskedTextProvider