Bagikan melalui


MaskedTextProvider Kelas

Definisi

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

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, Windows Forms menyediakannya sebagai layanan terpisah, yang diwakili oleh kelas MaskedTextProvider, yang mendefinisikan sintaks bahasa masking yang dibahas dalam dokumentasi untuk properti Mask.

Banyak anggota kelas MaskedTextBox merujuk implementasi mereka ke anggota bernama serupa dari MaskedTextProviderterkait . Misalnya, properti MaskedTextBox.PromptChar kelas MaskedTextBox mengacu pada semua akses ke PromptChar kelas MaskedTextProvider.

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 properti Mask.

Tiga string berbeda berikut terlibat dengan kelas MaskedTextProvider.

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

Nota

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, Boolean)

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

MaskedTextProvider(String, Char, Boolean)

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

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

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

MaskedTextProvider(String, CultureInfo, Boolean)

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

MaskedTextProvider(String, CultureInfo, Char, Boolean)

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

MaskedTextProvider(String, CultureInfo)

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

MaskedTextProvider(String)

Menginisialisasi instans baru kelas MaskedTextProvider menggunakan masker 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 masker karakter input paling kanan yang telah ditetapkan ke masker.

Length

Mendapatkan panjang masker, tidak ada karakter pengubah masker.

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, Int32, MaskedTextResultHint)

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

Add(Char)

Menambahkan karakter 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.

Add(String)

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

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 MaskedTextProvidersaat ini.

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 dapat diedit yang tidak ditetapkan antara posisi yang ditentukan menggunakan arah pencarian yang ditentukan.

GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetOperationResultFromHint(MaskedTextResultHint)

Menentukan apakah MaskedTextResultHint yang ditentukan menunjukkan keberhasilan atau kegagalan.

GetType()

Mendapatkan Type instans saat ini.

(Diperoleh dari Object)
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(Char, Int32)

Menyisipkan karakter yang ditentukan pada posisi yang ditentukan 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.

InsertAt(String, Int32)

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

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 Objectsaat ini.

(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, Int32, Int32, MaskedTextResultHint)

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

RemoveAt(Int32, Int32)

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

RemoveAt(Int32)

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

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(Char, Int32)

Mengganti satu karakter pada atau di luar posisi yang ditentukan dengan nilai karakter 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.

Replace(String, Int32)

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

Set(String, Int32, MaskedTextResultHint)

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

Set(String)

Mengatur string yang diformat ke string input yang ditentukan.

ToDisplayString()

Mengembalikan string yang diformat dalam bentuk yang dapat ditampilkan.

ToString()

Mengembalikan string berformat yang menyertakan semua nilai karakter yang ditetapkan.

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

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

ToString(Boolean, Boolean, Int32, Int32)

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

ToString(Boolean, Boolean)

Mengembalikan 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(Boolean)

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

ToString(Int32, Int32)

Mengembalikan substring 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 lolos pada posisi yang ditentukan.

VerifyString(String, Int32, MaskedTextResultHint)

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

VerifyString(String)

Menguji apakah string yang ditentukan dapat berhasil diatur.

Berlaku untuk

Lihat juga