MaskedTextBox.Mask Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Získá nebo nastaví vstupní masku pro použití 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

A String představující 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 zahrnují 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ý používá, je definován přidruženým MaskedTextProviderjazykem MaskedTextBox . Standardní zprostředkovatel určuje jazyk maskování na základě jazyka používaného ovládacím prvku Maskované úpravy v jazyce Visual Basic 6.0 a měl by být velmi známý pro uživatele, kteří migrují z této platformy.

Maskování – element Popis
0 Číslice, povinné. Tento prvek bude přijímat libovolnou jednu číslici mezi 0 a 9.
9 Číslice nebo mezera, volitelné.
# Číslice nebo mezera, volitelné. Pokud je tato pozice v masce prázdná, bude vykreslena jako mezera Text ve vlastnosti. Znaménka plus (+) a minus (-) jsou povolená.
L Písmeno, povinné. Omezuje vstup na písmena ASCII a-z a A-Z. Tento prvek masky je ekvivalentem [a-zA-Z] v regulárních výrazech.
? Písmeno, volitelné. Omezuje vstup na písmena ASCII a-z a A-Z. Tento element masky je ekvivalentem [a-zA-Z]? v regulárních výrazech.
& Znak, povinné. AsciiOnly Pokud je vlastnost nastavena na true, tento prvek se chová jako "L" element.
C Znak, nepovinný. Libovolný neovládaný znak. AsciiOnly Pokud je vlastnost nastavena na true, tento prvek se chová jako element "?".
A Alfanumerické, povinné. AsciiOnly Pokud je vlastnost nastavená na true, budou jedinými znaky, které bude přijímat, jsou písmena ASCII a-z a A-Z. Tento element masky se chová jako element "a".
pro Alfanumerické, volitelné. AsciiOnly Pokud je vlastnost nastavená na true, budou jedinými znaky, které bude přijímat, jsou písmena ASCII a-z a A-Z. Tento element masky se chová jako element "A".
. Zástupný symbol oddělovače desetinných míst. Skutečným použitým znakem zobrazení bude desetinný symbol odpovídající zprostředkovateli formátu, jak je určeno vlastností ovládacího prvku FormatProvider .
, Zástupný symbol Pro tisíce. Skutečným použitým znakem zobrazení bude zástupný symbol tisíců odpovídající zprostředkovateli formátu, jak je určeno vlastností ovládacího prvku FormatProvider .
: Oddělovač času. Skutečným použitým znakem zobrazení bude symbol času odpovídající zprostředkovateli formátu, jak je určeno vlastností ovládacího prvku FormatProvider .
/ Oddělovač data. Skutečným použitým znakem zobrazení bude symbol data odpovídající zprostředkovateli formátu, jak je určeno vlastností ovládacího prvku FormatProvider .
$ Symbol měny. Skutečný zobrazený znak bude symbol měny odpovídající zprostředkovateli formátu, jak je určeno vlastností ovládacího prvku FormatProvider .
< Posun dolů. Převede všechny následující znaky 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. Uteče znak masky a změní ho na literál. "\\" je řídicí sekvence zpětného lomítka.
Všechny ostatní znaky Literály. Všechny prvky, které nejsou maskou, se zobrazí jako samy 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, když MaskedTextBox už obsahuje uživatelský vstup 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 masky 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.

Symboly desetin (.), tisícin (,), času (:), data (/) a měny ($) ve výchozím nastavení zobrazují tyto symboly podle definice jazykové verze aplikace. Pomocí vlastnosti můžete vynutit, aby zobrazovaly symboly pro jinou jazykovou FormatProvider verzi.

Vkládání znaků do masky za běhu je řízeno InsertKeyMode vlastností . Uživatelé můžou procházet masku pomocí kláves se šipkami vlevo a vpravo nebo kurzorem 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 (den, zkratka měsíce a rok) ve formátu USA, ve kterém se zkratka měsíce se třemi písmeny zobrazí s počátečním velkým písmenem následovaným dvěma malými písmeny.
(999)-000-0000 USA telefonní číslo, volitelné směrové číslo oblasti. 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 představované první 0.
$999,999.00 Hodnota měny v rozsahu od 0 do 999999. Znaky měny, tisíciny a desetinné čárky budou za běhu nahrazeny jejich ekvivalenty specifické pro jazykovou verzi.

Platí pro

Viz také