MaskedTextProvider Třída

Definice

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

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í MaskedTextBox prvek obsahuje masku složenou z literálových znaků a elementů formátování, pomocí které testuje veškerý uživatelský vstup. Místo trvalého přidružení konkrétního modulu pro analýzu masky k MaskedTextBoxnástroji model Windows Forms ho poskytuje jako samostatnou službu reprezentovanou MaskedTextProvider třídou, která definuje syntaxi jazyka maskování probírané v dokumentaci k Mask vlastnosti.

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

Modul pro analýzu masek, který používá, MaskedTextProvider se modeluje podle ovládacího prvku Maskované úpravy, který je součástí microsoft Visual Basic verze 6. Jazyk maskování je popsaný v dokumentaci k Mask vlastnosti.

Následující tři různé řetězce jsou zapojeny do MaskedTextProvider třídy.

Název řetězce Description
Vstupní znak nebo řetězec Představuje znaky použité jako vstup, pro který je maska použita. Ve skutečnosti se vstupní řetězec může skládat z několika vstupních operací, včetně Addoperací , ReplaceInsertAt, a Remove. K vstupnímu řetězci proto nelze přistupovat přímo. Aspekty zpracování vstupního řetězce jsou však dostupné prostřednictvím AllowPromptAsInput vlastností a AsciiOnly, ResetOnPrompta ResetOnSpace .
Maska Představuje vstupní formátovací masku 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ě prostřednictvím Mask vlastnosti . Charakteristiky masky jsou k dispozici také prostřednictvím jiných členů, jako Lengthjsou vlastnosti , PasswordChara PromptChar .
Formátovaný řetězec Představuje řetězec, který je výsledkem při použití úplné masky na vstupní řetězec. Formátovaný řetězec lze dotazovat s mnoha členy třídy, včetně Item[], , LengthLastAssignedPosition, MaskFull, MaskCompleted, FindEditPositionFromatd. Úplná hodnota formátovaného řetězce je k dispozici v metodách ToDisplayString a ToString .

Poznámka

Vstupní řetězec může představovat přímý vstup uživatele, jako v případě MaskedTextBox, nebo může být generován jinými procesy, které nejsou přímo přidruženy k uživatelským vstupním/výstupním operacím.

Konstruktory

MaskedTextProvider(String)

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

MaskedTextProvider(String, Boolean)

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

MaskedTextProvider(String, Char, Boolean)

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

MaskedTextProvider(String, CultureInfo)

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

MaskedTextProvider(String, CultureInfo, Boolean)

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

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

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

MaskedTextProvider(String, CultureInfo, Char, Boolean)

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

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ého skrytého vstupu uživatele.

EditPositionCount

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

EditPositions

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

IncludeLiterals

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

IncludePrompt

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

InvalidIndex

Získá horní hranici oblasti neplatných indexů.

IsPassword

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

Item[Int32]

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

LastAssignedPosition

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

Length

Získá délku masky, chybí žádné znaky modifikátoru masky.

Mask

Získá vstupní masku.

MaskCompleted

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

MaskFull

Získá hodnotu označující, zda všechny požadované 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 vstupu uživatele pro všechny dostupné pozice úprav.

ResetOnPrompt

Získá nebo nastaví hodnotu, která určuje způsob zpracování vstupního znaku, který odpovídá znaku výzvy.

ResetOnSpace

Získá nebo nastaví hodnotu, která určuje, jak by měl být vstupní znak prostoru zpracován.

SkipLiterals

Získá nebo nastaví hodnotu označující, zda umístění znaků literálu v masce lze přepsat jejich stejnými hodnotami.

Metody

Add(Char)

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

Add(Char, Int32, MaskedTextResultHint)

Přidá zadaný vstupní znak na konec formátovaného řetězce a pak 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.

Add(String, Int32, MaskedTextResultHint)

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

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 MaskedTextProvidersouboru .

Equals(Object)

Určí, zda se zadaný objekt rovná 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í neupravitelné 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í hashovací funkce.

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

Určuje, zda zadaný MaskedTextResultHint označuje úspěch nebo neúspěch.

GetType()

Získá aktuální Type instanci.

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

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

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

Vloží zadaný řetězec 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.

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 Objectsouboru .

(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 pak vypíše pozici odebrání a popisné informace.

RemoveAt(Int32)

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

RemoveAt(Int32, Int32)

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

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.

Replace(Char, Int32)

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

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

Nahradí jeden znak mezi zadanou počáteční a koncovou pozicí 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 nad zadanou hodnotou znaku a pak vypíše pozici odebrání a popisné informace.

Replace(String, Int32)

Nahradí rozsah upravitelných znaků počínaje zadanou pozicí zadaným řetězcem.

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

Nahradí rozsah upravitelných znaků mezi zadaným počátečním a koncovým umístěním 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ích na zadané pozici zadaným řetězcem a potom vypíše pozici odebrání a popisné informace.

Set(String)

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

Set(String, Int32, MaskedTextResultHint)

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

ToDisplayString()

Vrátí formátovaný řetězec v zobrazované podobě.

ToString()

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

ToString(Boolean)

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

ToString(Boolean, Boolean)

Vrátí formátovaný řetězec, volitelně včetně znaků výzvy a literálu.

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

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

ToString(Boolean, Boolean, Int32, Int32)

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

ToString(Boolean, Int32, Int32)

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

ToString(Int32, Int32)

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

VerifyChar(Char, Int32, MaskedTextResultHint)

Testuje, zda lze zadaný znak úspěšně nastavit na zadané pozici.

VerifyEscapeChar(Char, Int32)

Testuje, zda zadaný znak bude řídicím znakem na zadané pozici.

VerifyString(String)

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

VerifyString(String, Int32, MaskedTextResultHint)

Testuje, zda zadaný řetězec může být úspěšně nastaven, a pak vypíše pozici a popisné informace.

Platí pro

Viz také