MaskedTextProvider Třída

Definice

Představuje službu analýzy masky, kterou lze použít libovolným počtem ovládacích prvků, které podporují maskování, jako je například ovládací prvek MaskedTextBox.

public ref class MaskedTextProvider : ICloneable
public class MaskedTextProvider : ICloneable
type MaskedTextProvider = class
    interface ICloneable
Public Class MaskedTextProvider
Implements ICloneable
Dědičnost
MaskedTextProvider
Implementuje

Poznámky

Ovládací prvek MaskedTextBox obsahuje masku složenou z literálových znaků a prvků formátování, které testuje veškerý uživatelský vstup. Namísto trvalého přidružení konkrétního modulu pro analýzu masky k MaskedTextBoxposkytuje Windows Forms jako samostatnou službu reprezentovanou třídou MaskedTextProvider, která definuje syntaxi jazyka maskování probíraného v dokumentaci pro vlastnost Mask.

Mnoho členů třídy MaskedTextBox odkazuje na jejich implementaci podobně pojmenované členy přidružené MaskedTextProvider. Například vlastnost MaskedTextBox.PromptChar třídy MaskedTextBox odkazuje na veškerý přístup k PromptChar třídy MaskedTextProvider.

Modul pro analýzu masky používaný MaskedTextProvider je modelován po ovládacím prvku Masked Edit, který je součástí microsoft Visual Basic verze 6. Jeho jazyk maskování je popsán v dokumentaci pro vlastnost Mask.

Následující tři odlišné řetězce jsou zapojeny do třídy MaskedTextProvider.

Název řetězce Popis
Vstupní znak nebo řetězec Představuje znaky použité jako vstup, pro který se maska použije. Ve skutečnosti se vstupní řetězec může skládat z více vstupních operací, včetně Add, Replace, InsertAta Remove. Vstupní řetězec proto nelze získat přístup přímo. Aspekty zpracování vstupních řetězců jsou však k dispozici, i když jsou vlastnosti AllowPromptAsInput a AsciiOnly, ResetOnPrompta ResetOnSpace.
Maska Představuje vstupní masku formátování použitou k transformaci vstupního řetězce na formátovaný řetězec. Tento řetězec je nastaven v MaskedTextProvider a přistupuje se primárně přes Mask vlastnost. Charakteristiky masky jsou k dispozici také prostřednictvím jiných členů, jako jsou vlastnosti Length, PasswordChara PromptChar.
Formátovaný řetězec Představuje řetězec, který má za následek použití úplné masky na vstupní řetězec. Formátovaný řetězec lze dotazovat s mnoha členy třídy, včetně Item[], Length, LastAssignedPosition, MaskFull, MaskCompleted, FindEditPositionFromatd. Úplná hodnota formátovaného řetězce je k dispozici z metod ToDisplayString a ToString.

Poznámka

Vstupní řetězec může představovat přímý uživatelský vstup, jako v případě MaskedTextBoxnebo mohou být generovány jinými procesy, které nejsou přímo spojené s uživatelskými vstupy a výstupy.

Konstruktory

MaskedTextProvider(String, Boolean)

Inicializuje novou instanci MaskedTextProvider třídy pomocí zadané masky a hodnoty omezení ASCII.

MaskedTextProvider(String, Char, Boolean)

Inicializuje novou instanci třídy MaskedTextProvider pomocí zadané masky, znaku hesla a hodnoty použití výzvy.

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

Inicializuje novou instanci třídy MaskedTextProvider pomocí zadané masky, jazykové verze, hodnoty použití výzvy, znak výzvy, znak hesla a hodnota omezení ASCII.

MaskedTextProvider(String, CultureInfo, Boolean)

Inicializuje novou instanci MaskedTextProvider třídy pomocí zadané masky, jazykové verze a hodnoty omezení ASCII.

MaskedTextProvider(String, CultureInfo, Char, Boolean)

Inicializuje novou instanci třídy MaskedTextProvider pomocí zadané masky, jazykové verze, znaku hesla a výzvy k použití hodnoty.

MaskedTextProvider(String, CultureInfo)

Inicializuje novou instanci třídy MaskedTextProvider pomocí zadané masky a jazykové verze.

MaskedTextProvider(String)

Inicializuje novou instanci třídy MaskedTextProvider pomocí zadané masky.

Vlastnosti

AllowPromptAsInput

Získá hodnotu označující, zda má být znak výzvy považován za platný vstupní znak, nebo ne.

AsciiOnly

Získá hodnotu určující, zda maska přijímá znaky mimo znakovou sadu ASCII.

AssignedEditPositionCount

Získá počet upravitelných pozic znaků, které již byly úspěšně přiřazeny vstupní hodnotu.

AvailableEditPositionCount

Získá počet upravitelných pozic znaků ve vstupní masce, které ještě nebyly přiřazeny vstupní hodnotu.

Culture

Získá jazykovou verzi, která určuje hodnotu lokalizovatelných oddělovačů a zástupných symbolů ve vstupní masce.

DefaultPasswordChar

Získá výchozí znak hesla použitý nejasný uživatelský vstup.

EditPositionCount

Získá počet upravitelných pozic ve formátovaný řetězec.

EditPositions

Získá nově vytvořený enumerátor pro upravitelné pozice ve formátovaný řetězec.

IncludeLiterals

Získá nebo nastaví hodnotu, která označuje, zda literálové znaky ve vstupní masce mají být zahrnuty do formátovaného řetězce.

IncludePrompt

Získá nebo nastaví hodnotu určující, zda PromptChar se používá k reprezentaci nepřítomnosti uživatelského vstupu při zobrazení formátovaného řetězce.

InvalidIndex

Získá horní mez rozsahu neplatných indexů.

IsPassword

Získá nebo nastaví hodnotu, která určuje, zda má být ochrana heslem použita na formátovaný řetězec.

Item[Int32]

Získá prvek na zadané pozici ve formátovaném řetězci.

LastAssignedPosition

Získá index v masce nejvíce vpravo vstupní znak, který byl přiřazen k masce.

Length

Získá délku masky, chybí všechny modifikační znaky masky.

Mask

Získá vstupní masku.

MaskCompleted

Získá hodnotu určující, zda všechny požadované vstupy byly zadány do formátovaného řetězce.

MaskFull

Získá hodnotu určující, zda všechny povinné a volitelné vstupy byly zadány do formátovaného řetězce.

PasswordChar

Získá nebo nastaví znak, který má být nahrazen skutečnými vstupními znaky.

PromptChar

Získá nebo nastaví znak použitý k reprezentaci nepřítomnosti uživatelského vstupu pro všechny dostupné pozice úprav.

ResetOnPrompt

Získá nebo nastaví hodnotu, která určuje, jak má být zpracován vstupní znak, který odpovídá znaku výzvy.

ResetOnSpace

Získá nebo nastaví hodnotu, která určuje způsob zpracování vstupního znaku mezery.

SkipLiterals

Získá nebo nastaví hodnotu určující, zda literálové pozice znaků v masce mohou být přepsány jejich stejnými hodnotami.

Metody

Add(Char, Int32, MaskedTextResultHint)

Přidá zadaný vstupní znak na konec formátovaného řetězce a potom zobrazí pozici a popisné informace.

Add(Char)

Přidá zadaný vstupní znak na konec formátovaného řetězce.

Add(String, Int32, MaskedTextResultHint)

Přidá znaky v zadaném vstupním řetězci na konec formátovaného řetězce a potom vypíše pozici a popisné informace.

Add(String)

Přidá znaky v zadaném vstupním řetězci na konec formátovaného řetězce.

Clear()

Vymaže všechny upravitelné vstupní znaky z formátovaného řetězce a nahradí je znaky výzvy.

Clear(MaskedTextResultHint)

Vymaže všechny upravitelné vstupní znaky z formátovaného řetězce, nahradí je znaky výzvy a pak vypíše popisné informace.

Clone()

Vytvoří kopii aktuálního MaskedTextProvider.

Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
FindAssignedEditPositionFrom(Int32, Boolean)

Vrátí pozici první přiřazené upravitelné pozice za zadanou pozicí pomocí zadaného směru hledání.

FindAssignedEditPositionInRange(Int32, Int32, Boolean)

Vrátí pozici první přiřazené upravitelné pozice mezi zadanými pozicemi pomocí zadaného směru hledání.

FindEditPositionFrom(Int32, Boolean)

Vrátí pozici první upravitelné pozice za zadanou pozicí pomocí zadaného směru hledání.

FindEditPositionInRange(Int32, Int32, Boolean)

Vrátí pozici první upravitelné pozice mezi zadanými pozicemi pomocí zadaného směru hledání.

FindNonEditPositionFrom(Int32, Boolean)

Vrátí pozici první neupravitelné pozice za zadanou pozicí pomocí zadaného směru hledání.

FindNonEditPositionInRange(Int32, Int32, Boolean)

Vrátí pozici první needitovatelné pozice mezi zadanými pozicemi pomocí zadaného směru hledání.

FindUnassignedEditPositionFrom(Int32, Boolean)

Vrátí pozici první nepřiřazené upravitelné pozice za zadanou pozicí pomocí zadaného směru hledání.

FindUnassignedEditPositionInRange(Int32, Int32, Boolean)

Vrátí pozici první nepřiřazené upravitelné pozice mezi zadanými pozicemi pomocí zadaného směru hledání.

GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetOperationResultFromHint(MaskedTextResultHint)

Určuje, zda zadaný MaskedTextResultHint označuje úspěch nebo selhání.

GetType()

Získá Type aktuální instance.

(Zděděno od Object)
InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Vloží zadaný znak na zadanou pozici v rámci formátovaného řetězce a vrátí poslední pozici vložení a stav operace.

InsertAt(Char, Int32)

Vloží zadaný znak na zadanou pozici v rámci formátovaného řetězce.

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Vloží zadaný řetězec na zadanou pozici v rámci formátovaného řetězce a vrátí poslední pozici vložení a stav operace.

InsertAt(String, Int32)

Vloží zadaný řetězec na zadanou pozici v rámci formátovaného řetězce.

IsAvailablePosition(Int32)

Určuje, zda je zadaná pozice k dispozici pro přiřazení.

IsEditPosition(Int32)

Určuje, zda je zadaná pozice upravitelná.

IsValidInputChar(Char)

Určuje, zda je zadaný znak platným vstupním znakem.

IsValidMaskChar(Char)

Určuje, zda je zadaný znak platným znakem masky.

IsValidPasswordChar(Char)

Určuje, zda je zadaný znak platným znakem hesla.

MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
Remove()

Odebere poslední přiřazený znak z formátovaného řetězce.

Remove(Int32, MaskedTextResultHint)

Odebere poslední přiřazený znak z formátovaného řetězce a potom vypíše pozici odebrání a popisné informace.

RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)

Odebere přiřazené znaky mezi zadanými pozicemi z formátovaného řetězce a potom vypíše pozici odebrání a popisné informace.

RemoveAt(Int32, Int32)

Odebere přiřazené znaky mezi zadanými pozicemi z formátovaného řetězce.

RemoveAt(Int32)

Odebere přiřazený znak na zadané pozici z formátovaného řetězce.

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

Nahradí jeden znak mezi zadanými počátečními a koncovými pozicemi zadanou hodnotou znaku a potom vypíše pozici odebrání a popisné informace.

Replace(Char, Int32, Int32, MaskedTextResultHint)

Nahradí jeden znak na zadané pozici nebo za zadanou hodnotou znaku a potom vypíše pozici odebrání a popisné informace.

Replace(Char, Int32)

Nahradí jeden znak na zadané pozici nebo nad zadanou hodnotou znaku.

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

Nahradí rozsah upravitelných znaků mezi zadanými počátečními a koncovými pozicemi zadaným řetězcem a potom vypíše pozici odebrání a popisné informace.

Replace(String, Int32, Int32, MaskedTextResultHint)

Nahradí rozsah upravitelných znaků začínající zadaným řetězcem a potom vypíše pozici odebrání a popisné informace.

Replace(String, Int32)

Nahradí rozsah upravitelných znaků začínající zadaným řetězcem.

Set(String, Int32, MaskedTextResultHint)

Nastaví formátovaný řetězec na zadaný vstupní řetězec a potom vypíše pozici odebrání a popisné informace.

Set(String)

Nastaví formátovaný řetězec na zadaný vstupní řetězec.

ToDisplayString()

Vrátí formátovaný řetězec ve formuláři, který lze zobrazit.

ToString()

Vrátí formátovaný řetězec, který obsahuje všechny přiřazené hodnoty znaků.

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

Vrátí podřetězce formátovaného řetězce, volitelně včetně znaků příkazového řádku, literálu a hesla.

ToString(Boolean, Boolean, Int32, Int32)

Vrátí podřetězce formátovaného řetězce, volitelně včetně znaků příkazového řádku a literálu.

ToString(Boolean, Boolean)

Vrátí formátovaný řetězec, volitelně včetně znaků příkazového řádku a literálu.

ToString(Boolean, Int32, Int32)

Vrátí podřetězce formátovaného řetězce, volitelně včetně znaků hesla.

ToString(Boolean)

Vrátí formátovaný řetězec, volitelně včetně znaků hesla.

ToString(Int32, Int32)

Vrátí podřetězc formátovaného řetězce.

VerifyChar(Char, Int32, MaskedTextResultHint)

Testuje, zda by zadaný znak mohl být úspěšně nastaven na zadané pozici.

VerifyEscapeChar(Char, Int32)

Testuje, zda by zadaný znak byl uchycený na zadané pozici.

VerifyString(String, Int32, MaskedTextResultHint)

Testuje, zda je možné zadaný řetězec úspěšně nastavit, a výstupem je pozice a popisné informace.

VerifyString(String)

Testuje, zda lze zadaný řetězec úspěšně nastavit.

Platí pro

Viz také