MaskedTextBox.Mask Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

MaskedTextBox.cs

Çalışma zamanında kullanılacak giriş maskesini alır veya ayarlar.

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

Özellik Değeri

String

String Geçerli maskeyi temsil eden bir. Varsayılan değer, herhangi bir girişe izin veren boş dizedir.

Özel durumlar

ArgumentException

özelliğine Mask sağlanan dize geçerli bir maske değil. Geçersiz maskeler, yazdırılamayan karakterler içeren maskeleri içerir.

Açıklamalar

Mask sınıfı için varsayılan özelliktir MaskedTextBox .

Mask aşağıdaki tabloda gösterildiği gibi bir veya daha fazla maskeleme öğesinden oluşan bir dize olmalıdır. tarafından MaskedTextBox kullanılan maskeleme dili, ilişkili MaskedTextProvidertarafından tanımlanır. Standart sağlayıcı, Visual Basic 6.0'da Maskelenmiş Düzenleme denetimi tarafından kullanılanı temel alan bir maskeleme dili belirtir ve bu platformdan geçiş gerçekleştiren kullanıcılara çok tanıdık olmalıdır.

Maskeleme öğesi	Açıklama
0	Basamak, gerekli. Bu öğe 0 ile 9 arasındaki tek basamakları kabul eder.
9	basamak veya boşluk, isteğe bağlı.
#	basamak veya boşluk, isteğe bağlı. Bu konum maskede boşsa, özelliğinde Text bir boşluk olarak işlenir. Artı (+) ve eksi (-) işaretlerine izin verilir.
L	Mektup, gerekli. Girişi a-z ve A-Z ASCII harfleriyle kısıtlar. Bu maske öğesi normal ifadelerde [a-zA-Z] ile eşdeğerdir.
?	Harf, isteğe bağlı. Girişi a-z ve A-Z ASCII harfleriyle kısıtlar. Bu maske öğesi [a-zA-Z] ile eşdeğer mi? normal ifadelerde.
&	Karakter, gerekli. AsciiOnly özelliği true olarak ayarlanırsa, bu öğe "L" öğesi gibi davranır.
C	Karakter, isteğe bağlı. Denetim dışı herhangi bir karakter. AsciiOnly özelliği olarak ayarlanırsatrue, bu öğe "?" öğesi gibi davranır.
A	Alfasayısal, gerekli. AsciiOnly özelliği olarak trueayarlanırsa, kabul edeceği tek karakterler a-z ve A-Z ASCII harfleridir. Bu maske öğesi "a" öğesi gibi davranır.
öö	Alfasayısal, isteğe bağlı. AsciiOnly özelliği olarak trueayarlanırsa, kabul edeceği tek karakterler a-z ve A-Z ASCII harfleridir. Bu maske öğesi "A" öğesi gibi davranır.
.	Ondalık yer tutucusu. Kullanılan gerçek görüntüleme karakteri, denetimin FormatProvider özelliği tarafından belirlenen biçim sağlayıcısına uygun ondalık simgesi olacaktır.
,	Binler yer tutucusu. Kullanılan gerçek görüntüleme karakteri, denetimin FormatProvider özelliği tarafından belirlenen biçim sağlayıcısına uygun binler yer tutucusu olacaktır.
:	Zaman ayırıcı. Kullanılan gerçek görüntüleme karakteri, denetimin FormatProvider özelliği tarafından belirlenen biçim sağlayıcısına uygun zaman simgesi olacaktır.
/	Tarih ayırıcı. Kullanılan gerçek görüntüleme karakteri, denetimin FormatProvider özelliği tarafından belirlenen biçim sağlayıcısına uygun tarih simgesi olacaktır.
$	Para birimi simgesi. Görüntülenen gerçek karakter, denetimin FormatProvider özelliği tarafından belirlenen biçim sağlayıcısına uygun para birimi simgesi olacaktır.
<	Aşağı kaydır. Takip eden tüm karakterleri küçük harfe dönüştürür.
>	Yukarı kaydır. Sonraki tüm karakterleri büyük harfe dönüştürür.
|	Önceki bir yukarı veya aşağı kaydırmayı devre dışı bırakın.
\	Kaçış. Bir maske karakterini değişmez karaktere dönüştürmek için kaçış işlemi uygular. "\\" ters eğik çizginin kaçış dizisidir.
Diğer karakterler	Hazır. Maske olmayan tüm öğeler, MaskedTextBox içinde kendileri olarak görünür. Değişmez değerler, çalışma zamanında maskede her zaman statik bir konum kaplar ve kullanıcı tarafından taşınamaz veya silinemez.

Önceki bir maskeye göre filtrelenmiş kullanıcı girişi içerdiğinde MaskedTextBox bir maskeyi değiştirirseniz, MaskedTextBox bu girişi yeni maske tanımına geçirmeye çalışır. Başarısız olursa, mevcut girişi temizler. Maske olarak sıfır uzunluklu bir dize atamak denetimdeki mevcut verileri korur. Sıfır uzunluklu bir maskeyle kullanıldığında, MaskedTextBox tek satırlı TextBox denetim gibi davranır.

Ondalık (.), binlik (,), saat (:), tarih (/) ve para birimi ($) simgeleri varsayılan olarak bu simgeleri uygulamanın kültüründe tanımlandığı şekilde görüntüler. özelliğini kullanarak bunları başka bir kültür için sembolleri görüntülemeye FormatProvider zorlayabilirsiniz.

Çalışma zamanında maskeye karakter ekleme özelliği tarafından InsertKeyMode denetlenmektedir. Kullanıcılar, sol ve sağ ok tuşlarını veya fare imlecini kullanarak maskede gezinebilir ve boşluk girerek maskedeki isteğe bağlı konumları atlayabilir.

Önemli

MaskedTextBox , vekiller ve dikey olarak birleştirilmiş karakterler dışında tüm Unicode karakterlerini destekler.

Aşağıdaki tabloda örnek maskeler gösterilmektedir.

Maske	Davranış
00/00/0000	Uluslararası tarih biçiminde bir tarih (gün, sayısal ay, yıl). "/" karakteri mantıksal bir tarih ayırıcıdır ve kullanıcıya uygulamanın geçerli kültürüne uygun tarih ayırıcısı olarak görünür.
00->L<LL-0000	Amerika Birleşik Devletleri formatında bir tarih (gün, ay kısaltması ve yıl), ay kısaltması üç harfli olacak şekilde ilk harfi büyük, sonraki iki harfi küçük yazılır.
(999)-000-0000	Amerika Birleşik Devletleri telefon numarası, alan kodu isteğe bağlı. Kullanıcılar isteğe bağlı karakterleri girmek istemezse, boşluk girebilir veya fare işaretçisini ilk 0 ile temsil edilen maskedeki konuma doğrudan yerleştirebilir.
$999,999.00	0 ile 999999 arasında bir para birimi değeri. Para birimi, binlik ve ondalık karakterler çalışma zamanında kültüre özgü eşdeğerleriyle değiştirilir.

Ayrıca bkz.

• Text
• MaskFull
• MaskCompleted
• MaskChanged
• MaskedTextProvider