MaskedTextBox.Mask Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

MaskedTextBox.cs

Získá nebo nastaví vstupní masku, která se má použít za běhu.

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

Hodnota vlastnosti

String

Představuje String aktuální masku. Výchozí hodnota je prázdný řetězec, který umožňuje jakýkoli vstup.

Výjimky

ArgumentException

Řetězec zadaný do Mask vlastnosti není platnou maskou. Neplatné masky obsahují masky obsahující netisknutelné znaky.

Poznámky

Mask je výchozí vlastnost třídy MaskedTextBox .

Mask musí být řetězec složený z jednoho nebo více prvků maskování, jak je znázorněno v následující tabulce. Jazyk maskování, který MaskedTextBox používá, je definován jeho přidruženým MaskedTextProvider. Standardní zprostředkovatel určuje jazyk maskování na základě jazyka, který používá ovládací prvek Masked Edit v jazyce Visual Basic 6.0 a měl by být velmi známý pro uživatele, kteří migrují z této platformy.

Maskovací prvek	Description
0	Číslice, povinné. Tento prvek přijme libovolnou jednu číslici v rozmezí od 0 do 9.
9	Číslice nebo mezera, volitelné.
#	Číslice nebo mezera, volitelné. Pokud je tato pozice v masce prázdná, zobrazí se jako mezera Text ve vlastnosti. Znaménka plus (+) a minus (-) jsou povolená.
L	Písmeno, povinné. Omezí vstup na písmena ASCII a-z a A-Z. Tento prvek masky je ekvivalentní [a-zA-Z] v regulárních výrazech.
?	Písmeno, volitelné. Omezí vstup na písmena ASCII a-z a A-Z. Tento prvek masky je ekvivalentní [a-zA-Z]? v regulárních výrazech.
&	Znak, povinný argument. AsciiOnly Pokud je vlastnost nastavena na hodnotu true, tento prvek se chová jako element "L".
C	Nepovinný znak. Libovolný neovládaný znak. Pokud je vlastnost nastavena AsciiOnly na true, tento prvek se chová jako element "?" element.
A	Alfanumerické, povinné. Pokud je vlastnost nastavena AsciiOnly na true, jediné znaky, které přijme, jsou písmena ASCII a-z a A-Z. Tento element masky se chová jako element "a".
a	Alfanumerické, volitelné. Pokud je vlastnost nastavena AsciiOnly na true, jediné znaky, které přijme, jsou písmena ASCII a-z a A-Z. Tento element masky se chová jako element A.
.	Zástupný symbol pro desetinnou hodnotu Použitý skutečný znak zobrazení bude desetinnou čárkou odpovídající zprostředkovateli formátu podle vlastnosti ovládacího prvku FormatProvider .
,	Zástupný symbol tisíců Použitý skutečný znak zobrazení bude zástupný symbol tisíců vhodný pro zprostředkovatele formátu podle vlastnosti ovládacího prvku FormatProvider .
:	Oddělovač času Použitý skutečný znak zobrazení bude symbolem času odpovídajícímu zprostředkovateli formátu podle vlastnosti ovládacího prvku FormatProvider .
/	Oddělovač kalendářních dat Použitý skutečný znak zobrazení bude symbolem data odpovídajícímu zprostředkovateli formátu podle vlastnosti ovládacího prvku FormatProvider .
$	Symbol měny. Skutečný znak zobrazený bude symbol měny odpovídající poskytovateli formátu podle vlastnosti ovládacího prvku FormatProvider .
<	Posuňte se dolů. Převede všechny znaky, které následují, na malá písmena.
>	Posun nahoru. Převede všechny následující znaky na velká písmena.
|	Zakažte předchozí posun nahoru nebo dolů.
\	Uniknout. Unikne znak masky a změní ho na literál. "\\ je úniková sekvence pro zpětné lomítko."
Všechny ostatní znaky	Literály. Všechny prvky, které nejsou maskovány, se zobrazí jako své vlastní v rámci MaskedTextBox. Literály vždy zabírají statickou pozici v masce za běhu a uživatel je nemůže přesunout ani odstranit.

Pokud změníte masku, pokud MaskedTextBox už obsahuje vstup uživatele filtrovaný předchozí maskou, MaskedTextBox pokusí se tento vstup migrovat do nové definice masky. Pokud selže, vymaže stávající vstup. Přiřazení řetězce nulové délky jako maska zachová všechna existující data v ovládacím prvku. Při použití s maskou MaskedTextBox nulové délky se chová jako jednořádkový TextBox ovládací prvek.

Desetinné číslo (.), tisíciny (,), čas (:), datum (/) a symbol měny ($) se standardně zobrazují tak, jak jsou definovány jazykovou verzí aplikace. Pomocí vlastnosti FormatProvider je můžete přinutit zobrazovat symboly pro jinou kulturu.

Vlastnost řídí vložení znaku do masky InsertKeyMode za běhu. Uživatelé mohou procházet masku pomocí kláves se šipkami doleva a doprava nebo kurzoru myši a můžou přeskočit volitelné pozice v masce zadáním mezery.

Důležité

MaskedTextBox podporuje všechny znaky Unicode s výjimkou náhradních a svisle sloučených znaků.

Následující tabulka ukazuje ukázkové masky.

Maska	Chování
00/00/0000	Datum (den, číselný měsíc, rok) v mezinárodním formátu data. Znak "/" je logický oddělovač kalendářních dat a zobrazí se uživateli jako oddělovač kalendářních dat odpovídající aktuální jazykové verzi aplikace.
00->L<LL-0000	Datum (zkratka dne, měsíce a rok) ve formátu USA, ve kterém se zobrazuje zkratka třímísmenného měsíce s počátečním velkým písmenem následovaným dvěma malými písmeny.
(999)-000-0000	Telefonní číslo v USA, předvolba oblasti volitelná. Pokud uživatelé nechtějí zadávat volitelné znaky, mohou buď zadat mezery, nebo umístit ukazatel myši přímo na pozici v masce reprezentované prvním 0.
$999,999.00	Hodnota měny v rozsahu od 0 do 999999. Měnové, tisícinové a desetinné znaky budou za běhu nahrazeny ekvivalenty v souladu s regionálními nastaveními.

Viz také

• Text
• MaskFull
• MaskCompleted
• MaskChanged
• MaskedTextProvider