MaskedTextBox.Mask Egenskap

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll
Källa:
MaskedTextBox.cs
Källa:
MaskedTextBox.cs
Källa:
MaskedTextBox.cs
Källa:
MaskedTextBox.cs
Källa:
MaskedTextBox.cs

Hämtar eller anger den indatamask som ska användas vid körning.

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

Egenskapsvärde

String

En String som representerar den aktuella masken. Standardvärdet är den tomma strängen som tillåter alla indata.

Undantag

ArgumentException

Strängen som anges i Mask egenskapen är inte en giltig mask. Ogiltiga masker innehåller masker som innehåller tecken som inte kan skrivas ut.

Kommentarer

Mask är standardegenskapen MaskedTextBox för klassen.

Mask måste vara en sträng som består av ett eller flera av maskeringselementen, enligt följande tabell. Maskeringsspråket som används av MaskedTextBox definieras av dess associerade MaskedTextProvider. Standardprovidern anger ett maskeringsspråk baserat på det som används av kontrollen Maskerad redigering i Visual Basic 6.0 och bör vara mycket bekant för användare som migrerar från den plattformen.

Maskeringselement Description
0 Siffra, obligatoriskt. Det här elementet accepterar alla ensiffriga tal mellan 0 och 9.
9 Siffra eller blanksteg, valfritt.
# Siffra eller blanksteg, valfritt. Om den här positionen är tom i masken återges den som ett blanksteg i egenskapen Text . Plustecken (+) och minustecken (-) tillåts.
L Brev, obligatoriskt. Begränsar indata till ASCII-bokstäverna a-z och A-Z. Det här maskelementet motsvarar [a-zA-Z] i reguljära uttryck.
? Bokstav, valfritt. Begränsar indata till ASCII-bokstäverna a-z och A-Z. Det här maskelementet motsvarar [a-zA-Z]? i reguljära uttryck.
& Tecken, obligatoriskt. Om egenskapen AsciiOnly är inställd på true fungerar det här elementet som L-elementet.
C Tecken, valfritt. Alla icke-kontrolltecken. Om egenskapen AsciiOnly är inställd på truebeter sig det här elementet som "?"-elementet.
A Alfanumeriskt, obligatoriskt. Om egenskapen AsciiOnly är inställd på trueär de enda tecken som den accepterar ASCII-bokstäverna a-z och A-Z. Det här maskelementet fungerar som "a"-elementet.
f Alfanumeriskt, valfritt. Om egenskapen AsciiOnly är inställd på trueär de enda tecken som den accepterar ASCII-bokstäverna a-z och A-Z. Det här maskelementet beter sig som "A"-elementet.
. Decimalplatshållare. Det faktiska visningstecknet som används är den decimalsymbol som är lämplig för formatprovidern, enligt kontrollens FormatProvider egenskap.
, Tusentals platshållare. Det faktiska visningstecknet som används är den tusentals platshållare som är lämplig för formatprovidern, enligt kontrollens FormatProvider egenskap.
: Tidsavgränsare. Det faktiska visningstecknet som används är den tidssymbol som är lämplig för formatprovidern, enligt kontrollens FormatProvider egenskap.
/ Datumavgränsare. Det faktiska visningstecken som används är den datumsymbol som är lämplig för formatprovidern, enligt kontrollens FormatProvider egenskap.
$ Valutasymbol. Det faktiska tecknet som visas är valutasymbolen som är lämplig för formatprovidern, enligt kontrollens FormatProvider egenskap.
< Flytta ner. Konverterar alla tecken som följer till gemener.
> Flytta upp. Konverterar alla tecken som följer till versaler.
| Inaktivera ett tidigare skift upp eller ned.
\ Fly. Gömmer ett masktecken och gör det till ett skrifttecken. "\\" är "escape-sekvensen" för ett omvänt snedstreck.
Alla andra tecken Litteraler. Alla icke-maskerade element visas som sig själva i MaskedTextBox. Literaler upptar alltid en statisk position i masken vid körning och kan inte flyttas eller tas bort av användaren.

Om du ändrar en mask när MaskedTextBox den redan innehåller användarindata som filtrerats av en tidigare mask, MaskedTextBox försöker du migrera indata till den nya maskdefinitionen. Om det misslyckas rensas befintliga indata. Om du tilldelar en sträng med noll längd som mask bevaras alla befintliga data i kontrollen. När den används med en mask MaskedTextBox med noll längd fungerar den som en enradskontroll TextBox .

Decimalsymbolerna (.), tusendelar (,), tid (:), datum (/) och valuta ($) är standard för att visa dessa symboler enligt definitionen i programmets kultur. Du kan tvinga dem att visa symboler för en annan kultur med hjälp FormatProvider av egenskapen .

Teckeninfogning i masken vid körning styrs av InsertKeyMode egenskapen . Användare kan navigera genom masken med hjälp av vänster- och högerpiltangenterna eller musmarkören och kan hoppa över valfria positioner i masken genom att ange ett blanksteg.

Important

MaskedTextBox stöder alla Unicode-tecken förutom surrogattecken och lodrätt kombinerade tecken.

I följande tabell visas exempelmasker.

Mask Behavior
00/00/0000 Ett datum (dag, numerisk månad, år) i internationellt datumformat. Tecknet "/" är en logisk datumavgränsare och visas för användaren som den datumavgränsare som är lämplig för programmets aktuella kultur.
00->L<LL-0000 Ett datum (dag, månadsförkortning och år) i USA-format där trestavig månadsförkortning visas med en inledande versal följt av två gemener.
(999)-000-0000 Telefonnummer i USA, riktnummer valfritt. Om användarna inte vill ange de valfria tecknen kan de antingen ange blanksteg eller placera pekaren direkt på positionen i masken som representeras av de första 0.
$999,999.00 Ett valutavärde i intervallet 0 till 999999. Valuta, tusendel och decimaltecken ersätts vid körning med deras kulturspecifika motsvarigheter.

Gäller för

Se även