Share via


MaskedTextProvider Kelas

Definisi

Mewakili layanan penguraian masker yang dapat digunakan oleh sejumlah kontrol yang mendukung masking, seperti MaskedTextBox kontrol.

public ref class MaskedTextProvider : ICloneable
public class MaskedTextProvider : ICloneable
type MaskedTextProvider = class
    interface ICloneable
Public Class MaskedTextProvider
Implements ICloneable
Warisan
MaskedTextProvider
Penerapan

Keterangan

Kontrol MaskedTextBox berisi masker, terdiri dari karakter harfiah dan elemen pemformatan, yang menguji semua input pengguna. Alih-alih mengaitkan mesin pengurai masker tertentu secara permanen dengan MaskedTextBox, Formulir Windows menyediakannya sebagai layanan terpisah, yang diwakili oleh MaskedTextProvider kelas , yang menentukan sintaks bahasa masking yang dibahas dalam dokumentasi untuk Mask properti .

Banyak anggota MaskedTextBox kelas merujuk implementasi mereka ke anggota yang sama bernama dari yang terkait MaskedTextProvider. Misalnya, MaskedTextBox.PromptChar properti MaskedTextBox kelas mengacu pada semua akses ke PromptCharMaskedTextProvider kelas .

Mesin penguraian masker yang digunakan oleh MaskedTextProvider dimodelkan setelah kontrol Masked Edit yang disertakan dalam Microsoft Visual Basic versi 6. Bahasa maskingnya dijelaskan dalam dokumentasi untuk Mask properti .

Tiga string berbeda berikut terlibat dengan MaskedTextProvider kelas .

Nama string Deskripsi
Karakter atau string input Mewakili karakter yang digunakan sebagai input yang diterapkan pada masker. Dalam aktualitas, string input dapat terdiri dari beberapa operasi input, termasuk Add, , ReplaceInsertAt, dan Remove. Oleh karena itu, string input tidak dapat diakses secara langsung. Namun, aspek penanganan string input tersedia melalui AllowPromptAsInput properti dan AsciiOnly, ResetOnPrompt, dan ResetOnSpace .
Mask Mewakili masker pemformatan input yang digunakan untuk mengubah string input menjadi string yang diformat. String ini diatur dalam MaskedTextProvider dan diakses terutama melalui Mask properti . Karakteristik masker juga tersedia melalui anggota lain, seperti Lengthproperti , , PasswordChardan PromptChar .
String yang diformat Mewakili string yang menghasilkan ketika masker lengkap diterapkan ke string input. String yang diformat dapat dikueri dengan banyak anggota kelas, termasuk Item[], , , LengthLastAssignedPosition, MaskFullMaskCompleted, FindEditPositionFrom, dan sebagainya. Nilai lengkap string yang diformat tersedia dari ToDisplayString metode dan ToString .

Catatan

String input dapat mewakili input pengguna langsung, seperti dalam kasus MaskedTextBox, atau dapat dihasilkan oleh proses lain yang tidak terkait langsung dengan operasi input/output pengguna.

Konstruktor

MaskedTextProvider(String)

Menginisialisasi instans MaskedTextProvider baru kelas menggunakan masker yang ditentukan.

MaskedTextProvider(String, Boolean)

Menginisialisasi instans MaskedTextProvider baru kelas menggunakan masker yang ditentukan dan nilai pembatasan ASCII.

MaskedTextProvider(String, Char, Boolean)

Menginisialisasi instans MaskedTextProvider baru kelas menggunakan masker, karakter kata sandi, dan nilai penggunaan prompt yang ditentukan.

MaskedTextProvider(String, CultureInfo)

Menginisialisasi instans MaskedTextProvider baru kelas menggunakan masker dan budaya yang ditentukan.

MaskedTextProvider(String, CultureInfo, Boolean)

Menginisialisasi instans MaskedTextProvider baru kelas menggunakan nilai pembatasan mask, budaya, dan ASCII yang ditentukan.

MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean)

Menginisialisasi instans MaskedTextProvider baru kelas menggunakan masker, budaya, nilai penggunaan prompt, karakter perintah, karakter kata sandi, dan nilai pembatasan ASCII yang ditentukan.

MaskedTextProvider(String, CultureInfo, Char, Boolean)

Menginisialisasi instans MaskedTextProvider baru kelas menggunakan masker, budaya, karakter kata sandi, dan nilai penggunaan perintah yang ditentukan.

Properti

AllowPromptAsInput

Mendapatkan nilai yang menunjukkan apakah karakter prompt harus diperlakukan sebagai karakter input yang valid atau tidak.

AsciiOnly

Mendapatkan nilai yang menunjukkan apakah masker menerima karakter di luar kumpulan karakter ASCII.

AssignedEditPositionCount

Mendapatkan jumlah posisi karakter yang dapat diedit yang telah berhasil diberi nilai input.

AvailableEditPositionCount

Mendapatkan jumlah posisi karakter yang dapat diedit dalam masker input yang belum diberi nilai input.

Culture

Mendapatkan budaya yang menentukan nilai pemisah dan tempat penampung yang dapat dilokalkan dalam masker input.

DefaultPasswordChar

Mendapatkan karakter kata sandi default yang digunakan input pengguna yang tidak jelas.

EditPositionCount

Mendapatkan jumlah posisi yang dapat diedit dalam string yang diformat.

EditPositions

Mendapatkan enumerator yang baru dibuat untuk posisi yang dapat diedit dalam string yang diformat.

IncludeLiterals

Mendapatkan atau menetapkan nilai yang menunjukkan apakah karakter harfiah dalam masker input harus disertakan dalam string yang diformat.

IncludePrompt

Mendapatkan atau menetapkan nilai yang menunjukkan apakah PromptChar digunakan untuk mewakili tidak adanya input pengguna saat menampilkan string yang diformat.

InvalidIndex

Mendapatkan batas atas rentang indeks yang tidak valid.

IsPassword

Mendapatkan atau menetapkan nilai yang menentukan apakah perlindungan kata sandi harus diterapkan ke string yang diformat.

Item[Int32]

Mendapatkan elemen pada posisi yang ditentukan dalam string yang diformat.

LastAssignedPosition

Mendapatkan indeks dalam topeng karakter input paling kanan yang telah ditetapkan ke masker.

Length

Mendapatkan panjang masker, tidak ada karakter pengubah masker apa pun.

Mask

Mendapatkan masker input.

MaskCompleted

Mendapatkan nilai yang menunjukkan apakah semua input yang diperlukan telah dimasukkan ke dalam string yang diformat.

MaskFull

Mendapatkan nilai yang menunjukkan apakah semua input yang diperlukan dan opsional telah dimasukkan ke dalam string yang diformat.

PasswordChar

Mendapatkan atau mengatur karakter yang akan diganti dengan karakter input aktual.

PromptChar

Mendapatkan atau mengatur karakter yang digunakan untuk mewakili tidak adanya input pengguna untuk semua posisi edit yang tersedia.

ResetOnPrompt

Mendapatkan atau menetapkan nilai yang menentukan bagaimana karakter input yang cocok dengan karakter prompt harus ditangani.

ResetOnSpace

Mendapatkan atau menetapkan nilai yang menentukan bagaimana karakter input spasi harus ditangani.

SkipLiterals

Mendapatkan atau menetapkan nilai yang menunjukkan apakah posisi karakter harfiah dalam masker dapat ditimpa oleh nilai yang sama.

Metode

Add(Char)

Menambahkan karakter input yang ditentukan ke akhir string yang diformat.

Add(Char, Int32, MaskedTextResultHint)

Menambahkan karakter input yang ditentukan ke akhir string yang diformat, lalu menghasilkan posisi dan informasi deskriptif.

Add(String)

Menambahkan karakter dalam string input yang ditentukan ke akhir string yang diformat.

Add(String, Int32, MaskedTextResultHint)

Menambahkan karakter dalam string input yang ditentukan ke akhir string yang diformat, lalu menghasilkan posisi dan informasi deskriptif.

Clear()

Menghapus semua karakter input yang dapat diedit dari string yang diformat, menggantinya dengan karakter perintah.

Clear(MaskedTextResultHint)

Menghapus semua karakter input yang dapat diedit dari string yang diformat, menggantinya dengan karakter perintah, lalu menghasilkan informasi deskriptif.

Clone()

Membuat salinan dari saat ini MaskedTextProvider.

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
FindAssignedEditPositionFrom(Int32, Boolean)

Mengembalikan posisi posisi pertama yang dapat diedit setelah posisi yang ditentukan menggunakan arah pencarian yang ditentukan.

FindAssignedEditPositionInRange(Int32, Int32, Boolean)

Mengembalikan posisi posisi pertama yang dapat diedit antara posisi yang ditentukan menggunakan arah pencarian yang ditentukan.

FindEditPositionFrom(Int32, Boolean)

Mengembalikan posisi posisi pertama yang dapat diedit setelah posisi yang ditentukan menggunakan arah pencarian yang ditentukan.

FindEditPositionInRange(Int32, Int32, Boolean)

Mengembalikan posisi posisi pertama yang dapat diedit antara posisi yang ditentukan menggunakan arah pencarian yang ditentukan.

FindNonEditPositionFrom(Int32, Boolean)

Mengembalikan posisi posisi pertama yang tidak dapat diedit setelah posisi yang ditentukan menggunakan arah pencarian yang ditentukan.

FindNonEditPositionInRange(Int32, Int32, Boolean)

Mengembalikan posisi posisi pertama yang tidak dapat diedit antara posisi yang ditentukan menggunakan arah pencarian yang ditentukan.

FindUnassignedEditPositionFrom(Int32, Boolean)

Mengembalikan posisi posisi pertama yang tidak ditetapkan dapat diedit setelah posisi yang ditentukan menggunakan arah pencarian yang ditentukan.

FindUnassignedEditPositionInRange(Int32, Int32, Boolean)

Mengembalikan posisi posisi pertama yang tidak ditetapkan dapat diedit di antara posisi yang ditentukan menggunakan arah pencarian yang ditentukan.

GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetOperationResultFromHint(MaskedTextResultHint)

Menentukan apakah yang ditentukan MaskedTextResultHint menunjukkan keberhasilan atau kegagalan.

GetType()

Mendapatkan instans Type saat ini.

(Diperoleh dari Object)
InsertAt(Char, Int32)

Menyisipkan karakter yang ditentukan pada posisi yang ditentukan dalam string yang diformat.

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Menyisipkan karakter yang ditentukan pada posisi yang ditentukan dalam string yang diformat, mengembalikan posisi penyisipan terakhir dan status operasi.

InsertAt(String, Int32)

Menyisipkan string yang ditentukan pada posisi tertentu dalam string yang diformat.

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Menyisipkan string yang ditentukan pada posisi yang ditentukan dalam string yang diformat, mengembalikan posisi penyisipan terakhir dan status operasi.

IsAvailablePosition(Int32)

Menentukan apakah posisi yang ditentukan tersedia untuk penugasan.

IsEditPosition(Int32)

Menentukan apakah posisi yang ditentukan dapat diedit.

IsValidInputChar(Char)

Menentukan apakah karakter yang ditentukan adalah karakter input yang valid.

IsValidMaskChar(Char)

Menentukan apakah karakter yang ditentukan adalah karakter masker yang valid.

IsValidPasswordChar(Char)

Menentukan apakah karakter yang ditentukan adalah karakter kata sandi yang valid.

MemberwiseClone()

Membuat salinan dangkal dari yang saat ini Object.

(Diperoleh dari Object)
Remove()

Menghapus karakter terakhir yang ditetapkan dari string yang diformat.

Remove(Int32, MaskedTextResultHint)

Menghapus karakter terakhir yang ditetapkan dari string yang diformat, lalu menghasilkan posisi penghapusan dan informasi deskriptif.

RemoveAt(Int32)

Menghapus karakter yang ditetapkan pada posisi yang ditentukan dari string yang diformat.

RemoveAt(Int32, Int32)

Menghapus karakter yang ditetapkan antara posisi yang ditentukan dari string yang diformat.

RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)

Menghapus karakter yang ditetapkan antara posisi yang ditentukan dari string yang diformat, lalu menghasilkan posisi penghapusan dan informasi deskriptif.

Replace(Char, Int32)

Mengganti satu karakter pada atau di luar posisi yang ditentukan dengan nilai karakter yang ditentukan.

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

Mengganti satu karakter antara posisi awal dan akhir yang ditentukan dengan nilai karakter yang ditentukan, lalu menghasilkan posisi penghapusan dan informasi deskriptif.

Replace(Char, Int32, Int32, MaskedTextResultHint)

Mengganti satu karakter pada atau di luar posisi yang ditentukan dengan nilai karakter yang ditentukan, lalu menghasilkan posisi penghapusan dan informasi deskriptif.

Replace(String, Int32)

Mengganti rentang karakter yang dapat diedit mulai dari posisi yang ditentukan dengan string yang ditentukan.

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

Mengganti rentang karakter yang dapat diedit antara posisi awal dan akhir yang ditentukan dengan string yang ditentukan, lalu menghasilkan posisi penghapusan dan informasi deskriptif.

Replace(String, Int32, Int32, MaskedTextResultHint)

Mengganti rentang karakter yang dapat diedit mulai dari posisi yang ditentukan dengan string yang ditentukan, lalu menghasilkan posisi penghapusan dan informasi deskriptif.

Set(String)

Mengatur string yang diformat ke string input yang ditentukan.

Set(String, Int32, MaskedTextResultHint)

Mengatur string yang diformat ke string input yang ditentukan, lalu menghasilkan posisi penghapusan dan informasi deskriptif.

ToDisplayString()

Mengembalikan string yang diformat dalam bentuk yang dapat ditampilkan.

ToString()

Mengembalikan string yang diformat yang menyertakan semua nilai karakter yang ditetapkan.

ToString(Boolean)

Mengembalikan string yang diformat, secara opsional termasuk karakter kata sandi.

ToString(Boolean, Boolean)

Mengembalikan string yang diformat, secara opsional termasuk perintah dan karakter harfiah.

ToString(Boolean, Boolean, Boolean, Int32, Int32)

Mengembalikan substring dari string yang diformat, secara opsional termasuk karakter perintah, harfiah, dan kata sandi.

ToString(Boolean, Boolean, Int32, Int32)

Mengembalikan substring string yang diformat, secara opsional termasuk karakter perintah dan harfiah.

ToString(Boolean, Int32, Int32)

Mengembalikan substring string yang diformat, secara opsional termasuk karakter kata sandi.

ToString(Int32, Int32)

Mengembalikan substring dari string yang diformat.

VerifyChar(Char, Int32, MaskedTextResultHint)

Menguji apakah karakter yang ditentukan dapat berhasil diatur pada posisi yang ditentukan.

VerifyEscapeChar(Char, Int32)

Menguji apakah karakter yang ditentukan akan diloloskan pada posisi yang ditentukan.

VerifyString(String)

Menguji apakah string yang ditentukan dapat berhasil diatur.

VerifyString(String, Int32, MaskedTextResultHint)

Menguji apakah string yang ditentukan dapat berhasil diatur, lalu menghasilkan posisi dan informasi deskriptif.

Berlaku untuk

Lihat juga