MaskedTextProvider Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

System.ComponentModel.TypeConverter.dll

Zdroj:

MaskedTextProvider.cs

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

Object

MaskedTextProvider

Implementuje

ICloneable

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.

Viz také

• MaskedTextBox
• MaskedTextProvider
• Mask