MaskedTextBox.Mask Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia maskę wprowadzania do użycia w czasie wykonywania.

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

Wartość właściwości

String

Reprezentująca String bieżącą maskę. Wartość domyślna to pusty ciąg, który zezwala na dowolne dane wejściowe.

Wyjątki

ArgumentException

Ciąg dostarczony do Mask właściwości nie jest prawidłową maską. Nieprawidłowe maski obejmują maski zawierające znaki niedrukowalne.

Uwagi

Mask jest domyślną właściwością MaskedTextBox klasy .

Mask musi być ciągiem składającym się z co najmniej jednego elementu maskowania, jak pokazano w poniższej tabeli. Język maskowania używany przez MaskedTextBox program jest definiowany przez skojarzony z MaskedTextProvidernim język . Dostawca standardowy określa język maskowania na podstawie języka używanego przez kontrolkę Masked Edit w programie Visual Basic 6.0 i powinien być bardzo znany użytkownikom migrujący z tej platformy.

Element maskowania	Opis
0	Cyfra, wymagana. Ten element zaakceptuje dowolną pojedynczą cyfrę z zakresu od 0 do 9.
9	Cyfra lub spacja, opcjonalnie.
#	Cyfra lub spacja, opcjonalnie. Jeśli ta pozycja jest pusta w masce, zostanie ona renderowana jako miejsce we Text właściwości . Znaki plus (+) i minus (-) są dozwolone.
L	List, wymagane. Ogranicza dane wejściowe do liter ASCII a-z i A-Z. Ten element maski jest odpowiednikiem [a-zA-Z] w wyrażeniach regularnych.
?	Litera, opcjonalnie. Ogranicza dane wejściowe do liter ASCII a-z i A-Z. Ten element maski jest odpowiednikiem [a-zA-Z]? w wyrażeniach regularnych.
&	Wymagany znak. Jeśli właściwość jest ustawiona AsciiOnly na wartość true, ten element zachowuje się jak element "L".
C	Znak, opcjonalny. Dowolny znak bez kontroli. Jeśli właściwość jest ustawiona AsciiOnly na true, ten element zachowuje się jak element "?".
A	Alfanumeryczne, wymagane. Jeśli właściwość jest ustawiona AsciiOnly na true, jedynymi znakami, które zaakceptuje, są litery ASCII a-z i A-Z. Ten element maski zachowuje się jak element "a".
a	Alfanumeryczne, opcjonalne. Jeśli właściwość jest ustawiona AsciiOnly na true, jedynymi znakami, które zaakceptuje, są litery ASCII a-z i A-Z. Ten element maski zachowuje się jak element "A".
.	Symbol zastępczy liczby dziesiętnej. Rzeczywisty używany znak wyświetlania będzie symbolem dziesiętny odpowiednim dla dostawcy formatu, zgodnie z właściwością kontrolki FormatProvider .
,	Symbol zastępczy tysięcy. Rzeczywisty używany znak wyświetlania będzie symbolem zastępczym tysięcy odpowiednich dla dostawcy formatu określonego przez właściwość kontrolki FormatProvider .
:	Separator godziny. Użyty rzeczywisty znak wyświetlania będzie symbolem czasu odpowiednim dla dostawcy formatu, zgodnie z właściwością kontrolki FormatProvider .
/	Separator daty. Użyty rzeczywisty znak wyświetlania będzie symbolem daty odpowiednim dla dostawcy formatu, zgodnie z właściwością kontrolki FormatProvider .
$	Symbol waluty. Wyświetlany rzeczywisty znak będzie symbolem waluty odpowiednim dla dostawcy formatu określonego przez właściwość kontrolki FormatProvider .
<	Przesuń w dół. Konwertuje wszystkie znaki, które następują do małych liter.
>	Przesuń w górę. Konwertuje wszystkie znaki następujące na wielkie litery.
|	Wyłącz poprzednie przesunięcie w górę lub przesuń w dół.
\	Uciec. Unika znaku maski, zamieniając go w literał. "\\" to sekwencja ucieczki ukośnika odwrotnego.
Wszystkie inne znaki	Literały. Wszystkie elementy bez maski będą wyświetlane jako same w elemecie MaskedTextBox. Literały zawsze zajmują pozycję statyczną w masce w czasie wykonywania i nie można ich przenosić ani usuwać przez użytkownika.

Jeśli zmienisz maskę, gdy MaskedTextBox już zawiera dane wejściowe użytkownika filtrowane przez poprzednią maskę, MaskedTextBox spróbujesz przeprowadzić migrację tych danych wejściowych do nowej definicji maski. Jeśli nie powiedzie się, wyczyści istniejące dane wejściowe. Przypisanie ciągu o zerowej długości jako maski spowoduje zachowanie wszystkich istniejących danych w kontrolce. W przypadku użycia z maską MaskedTextBox o zerowej długości zachowuje się jak kontrolka jednowierszowa TextBox .

Symbole dziesiętne (.), tysięczne (,), godziny (:), daty (/) i waluty ($) domyślnie wyświetlają te symbole zgodnie z definicją kultury aplikacji. Można wymusić wyświetlanie symboli dla innej kultury przy użyciu FormatProvider właściwości .

Wstawianie znaków do maski w czasie wykonywania jest kontrolowane przez InsertKeyMode właściwość . Użytkownicy mogą przechodzić przez maskę za pomocą klawiszy strzałek w lewo i w prawo lub kursora myszy i mogą pominąć opcjonalne pozycje w masce, wprowadzając spację.

Ważne

MaskedTextBox obsługuje wszystkie znaki Unicode z wyjątkiem znaków zastępczych i znaków połączonych pionowo.

W poniższej tabeli przedstawiono przykładowe maski.

Maska	Zachowanie
00/00/0000	Data (dzień, miesiąc liczbowy, rok) w formacie daty międzynarodowej. Znak "/" jest logicznym separatorem dat i będzie wyświetlany użytkownikowi jako separator daty odpowiedni dla bieżącej kultury aplikacji.
00->L<LL-0000	Data (dzień, skrót miesiąca i rok) w formacie Stany Zjednoczone, w którym jest wyświetlany trzyliterowy skrót miesiąca z początkową wielką literą, po której następuje dwie małe litery.
(999)-000-0000	Stany Zjednoczone numer telefonu, opcjonalny kod kierunkowy. Jeśli użytkownicy nie chcą wprowadzać opcjonalnych znaków, mogą wprowadzać spacje lub umieszczać wskaźnik myszy bezpośrednio w pozycji maski reprezentowanej przez pierwsze 0.
$999,999.00	Wartość waluty w zakresie od 0 do 999999. Znaki walutowe, tysięczne i dziesiętne zostaną zastąpione w czasie wykonywania ich odpowiednikami specyficznymi dla kultury.

Zobacz też

• Text
• MaskFull
• MaskCompleted
• MaskChanged
• MaskedTextProvider