MaskedTextProvider Osztály

Definíció

Olyan maszkoló szolgáltatást jelöl, amelyet tetszőleges számú, maszkolást támogató vezérlő használhat, például a MaskedTextBox vezérlő.

public ref class MaskedTextProvider : ICloneable
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicConstructors)]
public class MaskedTextProvider : ICloneable
public class MaskedTextProvider : ICloneable
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicConstructors)>]
type MaskedTextProvider = class
    interface ICloneable
type MaskedTextProvider = class
    interface ICloneable
Public Class MaskedTextProvider
Implements ICloneable
Öröklődés
MaskedTextProvider
Attribútumok
Megvalósítás

Megjegyzések

A MaskedTextBox vezérlőelem tartalmaz egy, a konstans karakterekből és formázási elemekből álló maszkot, amelyen az összes felhasználói bemenetet teszteli. Ahelyett, hogy véglegesen társítanál egy adott maszkoló motort MaskedTextBox, Windows Forms külön szolgáltatásként biztosítja azt, amelyet a MaskedTextProvider osztály jelöl, amely meghatározza a Mask tulajdonság dokumentációjában tárgyalt maszkoló nyelv szintaxisát.

Az osztály számos tagja a MaskedTextBox végrehajtásukra hivatkozik a társított taghoz hasonlóan elnevezett tagokra MaskedTextProvider. Az osztály tulajdonsága például MaskedTextBox.PromptChar az MaskedTextBox osztály minden hozzáférésére PromptCharMaskedTextProvider hivatkozik.

A MaskedTextProvider által használt maszkoló motor a Microsoft Visual Basic 6-os verziójában található Maszkolt szerkesztés vezérlő után modellezhető. A maszkolás nyelvét a tulajdonság dokumentációja Mask ismerteti.

Az osztály a következő három különböző sztringet MaskedTextProvider tartalmazza.

Sztring neve Leírás
Bemeneti karakter vagy sztring A maszk bemeneteként használt karaktereket jelöli. A bemeneti sztring valójában több bemeneti műveletből állhat, beleértve a Add, Replace, InsertAtés Remove. Ezért a bemeneti sztring nem érhető el közvetlenül. A bemeneti sztringek kezelésének szempontjai azonban az ésAllowPromptAsInput, AsciiOnlyés ResetOnPrompt a tulajdonságok ellenére ResetOnSpace is elérhetők.
Mask A bemeneti sztring formázott sztringgé alakításához használt beviteli formázási maszkot jelöli. Ez a sztring a tulajdonságban MaskedTextProvider van beállítva, és elsősorban a Mask tulajdonságban érhető el. A maszk jellemzői más tagokon keresztül is elérhetők, például a Length, PasswordCharés PromptChar a tulajdonságok.
Formázott sztring Azt a sztringet jelöli, amely a teljes maszk beviteli sztringre való alkalmazásakor jön létre. A formázott sztring lekérdezhető az osztály számos tagjával, beleértve Item[]a , , Length, LastAssignedPositionMaskFull, MaskCompleted, FindEditPositionFromstb. A formázott sztring teljes értéke elérhető a ToDisplayString metódusokból.ToString

Note

A bemeneti sztring jelentheti a közvetlen felhasználói bemenetet, ahogyan az a MaskedTextBoxfelhasználói bemeneti/kimeneti műveletekhez közvetlenül nem társított egyéb folyamatok esetében is lehetséges.

Konstruktorok

Name Description
MaskedTextProvider(String, Boolean)

Inicializálja az osztály új példányát a MaskedTextProvider megadott maszk és ASCII-korlátozási érték használatával.

MaskedTextProvider(String, Char, Boolean)

Inicializálja az osztály új példányát a MaskedTextProvider megadott maszk, jelszó karakter és a kérés használati értéke alapján.

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

Inicializálja az osztály új példányát a MaskedTextProvider megadott maszk, kultúra, parancssori használati érték, parancssori karakter, jelszó karakter és ASCII-korlátozási érték használatával.

MaskedTextProvider(String, CultureInfo, Boolean)

Inicializálja az osztály új példányát a MaskedTextProvider megadott maszk, kultúra és ASCII-korlátozási érték használatával.

MaskedTextProvider(String, CultureInfo, Char, Boolean)

Inicializálja az osztály új példányát a MaskedTextProvider megadott maszk, kultúra, jelszó karakter és a kérés használati értéke alapján.

MaskedTextProvider(String, CultureInfo)

Inicializálja az osztály új példányát a MaskedTextProvider megadott maszk és kultúra használatával.

MaskedTextProvider(String)

Inicializálja az osztály új példányát a MaskedTextProvider megadott maszk használatával.

Tulajdonságok

Name Description
AllowPromptAsInput

Beolvas egy értéket, amely jelzi, hogy a parancssori karaktert érvényes bemeneti karakterként kell-e kezelni.

AsciiOnly

Beolvas egy értéket, amely jelzi, hogy a maszk elfogadja-e az ASCII-karakterkészleten kívüli karaktereket.

AssignedEditPositionCount

A bemeneti értékhez már sikeresen hozzárendelt szerkeszthető karakterpozíciók számát adja meg.

AvailableEditPositionCount

A beviteli maszkban lévő szerkeszthető karakterpozíciók számát adja meg, amelyekhez még nincs bemeneti érték hozzárendelve.

Culture

Lekéri a bemeneti maszkban a honosítható elválasztók és helyőrzők értékét meghatározó kultúrát.

DefaultPasswordChar

Lekéri a felhasználó által használt alapértelmezett jelszójelet.

EditPositionCount

Lekéri a formázott sztring szerkeszthető pozícióinak számát.

EditPositions

Lekéri a formázott sztring szerkeszthető pozícióinak újonnan létrehozott enumerátorát.

IncludeLiterals

Olyan értéket kap vagy állít be, amely jelzi, hogy a beviteli maszkban szereplő literális karaktereknek szerepelnie kell-e a formázott sztringben.

IncludePrompt

Lekéri vagy beállít egy értéket, amely jelzi, hogy a formázott sztring megjelenítésekor a felhasználói bemenet hiányát jelzi-e PromptChar .

InvalidIndex

Lekéri az érvénytelen indexek tartományának felső határát.

IsPassword

Lekéri vagy beállít egy értéket, amely meghatározza, hogy a formázott sztringre jelszóvédelmet kell-e alkalmazni.

Item[Int32]

Lekéri az elemet a formázott sztring megadott helyén.

LastAssignedPosition

Lekéri az indexet a maszkhoz rendelt jobb szélső beviteli karakter maszkjában.

Length

Lekéri a maszk hosszát, és nem tartalmaz maszk módosító karaktereket.

Mask

Lekéri a bemeneti maszkot.

MaskCompleted

Beolvas egy értéket, amely jelzi, hogy az összes szükséges bemenet be lett-e írva a formázott sztringbe.

MaskFull

Beolvas egy értéket, amely jelzi, hogy az összes szükséges és opcionális bemenet be lett-e írva a formázott sztringbe.

PasswordChar

Lekéri vagy beállítja, hogy a tényleges bemeneti karakterek helyett a karaktert helyettesítse.

PromptChar

Lekéri vagy beállítja azt a karaktert, amely az összes elérhető szerkesztési pozícióhoz tartozó felhasználói bevitel hiányát jelzi.

ResetOnPrompt

Lekéri vagy beállít egy értéket, amely meghatározza, hogyan kell kezelni a parancssori karakternek megfelelő bemeneti karaktert.

ResetOnSpace

Lekéri vagy beállít egy értéket, amely meghatározza a térbemeneti karakter kezelését.

SkipLiterals

Beolvas vagy beállít egy értéket, amely jelzi, hogy a maszkban lévő literális karakterpozíciók felülírhatók-e ugyanazokkal az értékekkel.

Metódusok

Name Description
Add(Char, Int32, MaskedTextResultHint)

Hozzáadja a megadott bemeneti karaktert a formázott sztring végéhez, majd kiírja a pozíciót és a leíró információkat.

Add(Char)

Hozzáadja a megadott bemeneti karaktert a formázott sztring végéhez.

Add(String, Int32, MaskedTextResultHint)

Hozzáadja a megadott bemeneti sztringben lévő karaktereket a formázott sztring végéhez, majd megadja a pozíciót és a leíró adatokat.

Add(String)

Hozzáadja a megadott bemeneti sztringben lévő karaktereket a formázott sztring végéhez.

Clear()

Törli az összes szerkeszthető bemeneti karaktert a formázott sztringből, és parancssori karakterekre cseréli őket.

Clear(MaskedTextResultHint)

Törli az összes szerkeszthető bemeneti karaktert a formázott sztringből, lecseréli őket parancssori karakterekre, majd leíró információkat ad ki.

Clone()

Másolatot készít az aktuálisról MaskedTextProvider.

Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
FindAssignedEditPositionFrom(Int32, Boolean)

Az első hozzárendelt szerkeszthető pozíció pozícióját adja vissza a megadott pozíció után a megadott keresési irány használatával.

FindAssignedEditPositionInRange(Int32, Int32, Boolean)

Az első hozzárendelt szerkeszthető pozíció pozícióját adja vissza a megadott pozíciók között a megadott keresési irány használatával.

FindEditPositionFrom(Int32, Boolean)

Az első szerkeszthető pozíció pozícióját adja vissza a megadott pozíció után a megadott keresési irány használatával.

FindEditPositionInRange(Int32, Int32, Boolean)

Az első szerkeszthető pozíció pozícióját adja vissza a megadott pozíciók között a megadott keresési irány használatával.

FindNonEditPositionFrom(Int32, Boolean)

Az első nem szerkeszthető pozíció pozícióját adja vissza a megadott pozíció után a megadott keresési irány használatával.

FindNonEditPositionInRange(Int32, Int32, Boolean)

Az első nem szerkeszthető pozíció pozícióját adja vissza a megadott pozíciók között a megadott keresési irány használatával.

FindUnassignedEditPositionFrom(Int32, Boolean)

Az első hozzárendeletlen szerkeszthető pozíció pozícióját adja vissza a megadott pozíció után a megadott keresési irány használatával.

FindUnassignedEditPositionInRange(Int32, Int32, Boolean)

Az első hozzárendeletlen szerkeszthető pozíció pozícióját adja vissza a megadott pozíciók között a megadott keresési irány használatával.

GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetOperationResultFromHint(MaskedTextResultHint)

Meghatározza, hogy a megadott MaskedTextResultHint érték sikert vagy hibát jelez-e.

GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Beszúrja a megadott karaktert a megadott pozícióba a formázott sztringen belül, visszaadva az utolsó beszúrási pozíciót és a művelet állapotát.

InsertAt(Char, Int32)

Beszúrja a megadott karaktert a megadott pozícióba a formázott sztringen belül.

InsertAt(String, Int32, Int32, MaskedTextResultHint)

A megadott sztringet a formázott sztring egy megadott helyére szúrja be, visszaadva az utolsó beszúrási pozíciót és a művelet állapotát.

InsertAt(String, Int32)

Beszúrja a megadott sztringet egy megadott helyre a formázott sztringen belül.

IsAvailablePosition(Int32)

Meghatározza, hogy a megadott pozíció elérhető-e a hozzárendeléshez.

IsEditPosition(Int32)

Meghatározza, hogy a megadott pozíció szerkeszthető-e.

IsValidInputChar(Char)

Meghatározza, hogy a megadott karakter érvényes bemeneti karakter-e.

IsValidMaskChar(Char)

Meghatározza, hogy a megadott karakter érvényes maszkkaraktere-e.

IsValidPasswordChar(Char)

Meghatározza, hogy a megadott karakter érvényes jelszó karakter-e.

MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
Remove()

Eltávolítja az utolsó hozzárendelt karaktert a formázott sztringből.

Remove(Int32, MaskedTextResultHint)

Eltávolítja az utolsó hozzárendelt karaktert a formázott sztringből, majd kiírja az eltávolítási pozíciót és a leíró információkat.

RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)

Eltávolítja a hozzárendelt karaktereket a megadott pozíciók között a formázott sztringből, majd kiírja az eltávolítási pozíciót és a leíró információkat.

RemoveAt(Int32, Int32)

Eltávolítja a hozzárendelt karaktereket a megadott pozíciók között a formázott sztringből.

RemoveAt(Int32)

Eltávolítja a megadott pozícióban lévő hozzárendelt karaktert a formázott sztringből.

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

Egyetlen karaktert cserél le a megadott kezdő és záró pozíciók között a megadott karakterértékre, majd az eltávolítási pozíciót és a leíró információkat adja ki.

Replace(Char, Int32, Int32, MaskedTextResultHint)

A megadott pozícióban vagy azon túl lévő karaktereket lecseréli a megadott karakterértékre, majd az eltávolítási pozíciót és a leíró információkat adja ki.

Replace(Char, Int32)

A megadott pozíciónál vagy azon túl lévő karaktereket a megadott karakterértékre cseréli.

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

A megadott kezdő és záró pozíciók közötti szerkeszthető karakterek tartományát lecseréli a megadott sztringre, majd az eltávolítási pozíciót és a leíró adatokat adja ki.

Replace(String, Int32, Int32, MaskedTextResultHint)

A megadott pozíciótól kezdődő szerkeszthető karakterek tartományát lecseréli a megadott sztringre, majd az eltávolítási pozíciót és a leíró információkat adja ki.

Replace(String, Int32)

A megadott pozíciótól kezdődő szerkeszthető karakterek tartományát lecseréli a megadott sztringre.

Set(String, Int32, MaskedTextResultHint)

A formázott sztringet a megadott bemeneti sztringre állítja, majd kiírja az eltávolítási pozíciót és a leíró információkat.

Set(String)

A formázott sztringet a megadott bemeneti sztringre állítja.

ToDisplayString()

Megjeleníthető formában adja vissza a formázott sztringet.

ToString()

A hozzárendelt karakterértékeket tartalmazó formázott sztringet adja vissza.

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

A formázott sztring részsztringét adja vissza, opcionálisan a parancssori, a literális és a jelszókaraktereket is beleértve.

ToString(Boolean, Boolean, Int32, Int32)

A formázott sztring egy részsztringét adja vissza, opcionálisan a parancssori és a literális karaktereket is beleértve.

ToString(Boolean, Boolean)

A formázott sztringet adja vissza, opcionálisan a parancssori és a literális karaktereket is beleértve.

ToString(Boolean, Int32, Int32)

A formázott sztring részsztringét adja vissza, opcionálisan jelszókaraktereket is beleértve.

ToString(Boolean)

A formázott sztringet adja vissza, opcionálisan jelszókarakterek használatával.

ToString(Int32, Int32)

A formázott sztring egy részszúrását adja vissza.

VerifyChar(Char, Int32, MaskedTextResultHint)

Ellenőrzi, hogy a megadott karakter sikeresen be van-e állítva a megadott pozícióban.

VerifyEscapeChar(Char, Int32)

Azt ellenőrzi, hogy a megadott karakter a megadott pozícióban van-e megszökve.

VerifyString(String, Int32, MaskedTextResultHint)

Ellenőrzi, hogy a megadott sztring sikeresen be van-e állítva, majd megadja a pozíciót és a leíró adatokat.

VerifyString(String)

Ellenőrzi, hogy a megadott sztring sikeresen be van-e állítva.

A következőre érvényes:

Lásd még