MaskedTextBox.Mask Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan atau mengatur masker input untuk digunakan pada durasi.

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

Nilai Properti

String

mewakili String masker saat ini. Nilai default adalah string kosong yang memungkinkan input apa pun.

Pengecualian

ArgumentException

String yang diberikan ke Mask properti bukan masker yang valid. Masker yang tidak valid mencakup masker yang berisi karakter yang tidak dapat dicetak.

Keterangan

Mask adalah properti default untuk MaskedTextBox kelas .

Mask harus berupa string yang terdiri dari satu atau beberapa elemen masking, seperti yang ditunjukkan dalam tabel berikut. Bahasa masking yang digunakan oleh MaskedTextBox didefinisikan oleh yang terkait MaskedTextProvider. Penyedia standar menentukan bahasa masking berdasarkan yang digunakan oleh kontrol Masked Edit di Visual Basic 6.0, dan harus sangat akrab bagi pengguna yang bermigrasi dari platform tersebut.

Elemen masking	Deskripsi
0	Digit, diperlukan. Elemen ini akan menerima satu digit antara 0 dan 9.
9	Digit atau spasi, opsional.
#	Digit atau spasi, opsional. Jika posisi ini kosong di masker, posisi ini akan dirender sebagai spasi Text di properti . Tanda plus (+) dan minus (-) diizinkan.
L	Surat, diperlukan. Membatasi input ke huruf ASCII a-z dan A-Z. Elemen masker ini setara dengan [a-zA-Z] dalam ekspresi reguler.
?	Huruf, opsional. Membatasi input ke huruf ASCII a-z dan A-Z. Elemen masker ini setara dengan [a-zA-Z]? dalam ekspresi reguler.
&	Karakter, diperlukan. AsciiOnly Jika properti diatur ke true, elemen ini berperilaku seperti elemen "L".
C	Karakter, opsional. Karakter nonkontrol apa pun. AsciiOnly Jika properti diatur ke true, elemen ini berperilaku seperti elemen "?".
A	Alfanumerik, diperlukan. AsciiOnly Jika properti diatur ke true, satu-satunya karakter yang akan diterimanya adalah huruf ASCII a-z dan A-Z. Elemen masker ini berulah seperti elemen "a".
a	Alfanumerik, opsional. AsciiOnly Jika properti diatur ke true, satu-satunya karakter yang akan diterimanya adalah huruf ASCII a-z dan A-Z. Elemen masker ini berulah seperti elemen "A".
.	Tempat penampung desimal. Karakter tampilan aktual yang digunakan akan menjadi simbol desimal yang sesuai dengan penyedia format, seperti yang ditentukan oleh properti kontrol FormatProvider .
,	Ribuan tempat penampung. Karakter tampilan aktual yang digunakan akan menjadi tempat penampung ribuan yang sesuai dengan penyedia format, seperti yang ditentukan oleh properti kontrol FormatProvider .
:	Pemisah waktu. Karakter tampilan aktual yang digunakan akan menjadi simbol waktu yang sesuai dengan penyedia format, seperti yang ditentukan oleh properti kontrol FormatProvider .
/	Pemisah tanggal. Karakter tampilan aktual yang digunakan akan menjadi simbol tanggal yang sesuai dengan penyedia format, seperti yang ditentukan oleh properti kontrol FormatProvider .
$	Simbol mata uang. Karakter aktual yang ditampilkan akan menjadi simbol mata uang yang sesuai dengan penyedia format, seperti yang ditentukan oleh properti kontrol FormatProvider .
<	Geser ke bawah. Mengonversi semua karakter yang mengikuti menjadi huruf kecil.
>	Geser ke atas. Mengonversi semua karakter yang mengikuti menjadi huruf besar.
|	Nonaktifkan shift sebelumnya ke atas atau geser ke bawah.
\	Melarikan diri. Melepaskan karakter mask, mengubahnya menjadi harfiah. "\\" adalah urutan pelepasan untuk garis miring terbalik.
Semua karakter lainnya	Harfiah. Semua elemen non-mask akan muncul dalam MaskedTextBox. Literal selalu menempati posisi statis di masker pada durasi, dan tidak dapat dipindahkan atau dihapus oleh pengguna.

Jika Anda mengubah masker saat MaskedTextBox sudah berisi input pengguna yang difilter oleh masker sebelumnya, MaskedTextBox akan mencoba memigrasikan input tersebut ke dalam definisi masker baru. Jika gagal, itu akan menghapus input yang ada. Menetapkan string panjang nol karena masker akan mempertahankan data yang ada dalam kontrol. Saat digunakan dengan masker panjang nol, MaskedTextBox berwujud seperti kontrol garis TextBox tunggal.

Simbol desimal (.), seperseribu (,), waktu (:), tanggal (/), dan mata uang ($) default untuk menampilkan simbol-simbol tersebut sebagaimana didefinisikan oleh budaya aplikasi. Anda dapat memaksanya untuk menampilkan simbol untuk budaya lain dengan menggunakan properti FormatProvider.

Penyisipan karakter ke dalam masker pada durasi dikontrol oleh InsertKeyMode properti . Pengguna dapat menavigasi melalui masker dengan menggunakan tombol panah kiri dan kanan atau kursor mouse, dan dapat melewati posisi opsional di masker dengan memasukkan spasi.

Penting

MaskedTextBox mendukung semua karakter Unicode kecuali untuk pengganti dan karakter gabungan vertikal.

Tabel berikut ini memperlihatkan contoh masker.

Mask	Aktivitas
00/00/0000	Tanggal (hari, bulan numerik, tahun) dalam format tanggal internasional. Karakter "/" adalah pemisah tanggal logis, dan akan muncul kepada pengguna sebagai pemisah tanggal yang sesuai dengan budaya aplikasi saat ini.
00->L<LL-0000	Tanggal (hari, singkatan bulan, dan tahun) dalam format Amerika Serikat di mana singkatan bulan tiga huruf ditampilkan dengan huruf besar awal diikuti dengan dua huruf kecil.
(999)-000-0000	Nomor telepon Amerika Serikat, kode area opsional. Jika pengguna tidak ingin memasukkan karakter opsional, mereka dapat memasukkan spasi atau menempatkan penunjuk mouse langsung pada posisi di masker yang diwakili oleh 0 pertama.
$999,999.00	Nilai mata uang dalam rentang 0 hingga 999999. Karakter mata uang, seperseribu, dan desimal akan digantikan pada durasi dengan padanan khusus budayanya.

Lihat juga

• Text
• MaskFull
• MaskCompleted
• MaskChanged
• MaskedTextProvider