Share via

MaskedTextBox.Mask Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Ç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 aşina 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ğerdir. 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 olmayan 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.
a 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.
: Tarih ayırıcısı. 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ısı. 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. İzleyen tüm karakterleri küçük harfe dönüştürür.
> Yukarı kaydır. İzleyen 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çış. Maske karakterinden kurtularak değişmez değere dönüştürür. "\\", ters eğik çizginin kaçış dizisidir.
Diğer karakterler Hazır. Maskelenmeyen tüm öğeler içinde MaskedTextBoxkendileri gibi görünür. Değişmez değerler her zaman çalışma zamanında maskede 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 maskeyle kullanıldığında, MaskedTextBox tek satırlı TextBox denetim gibi davranır.

Ondalık (.), binde (,), saat (:), tarih (/) ve para birimi ($) simgeleri varsayılan olarak bu simgeleri uygulamanın kültürü tarafından 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 karakterleri destekler.

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

Maskeleme 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ı olarak görünür.
00->L<LL-0000 Üç harfli ay kısaltmasının ilk büyük harf ve ardından iki küçük harfle görüntülendiği Birleşik Devletler biçimde bir tarih (gün, ay kısaltması ve yıl).
(999)-000-0000 Birleşik Devletler 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 doğrudan ilk 0 ile temsil edilen maskedeki konuma yerleştirebilirler.
$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.

Şunlara uygulanır

Ayrıca bkz.