Udostępnij za pośrednictwem


MaskedTextProvider Klasa

Definicja

Reprezentuje usługę analizowania maski, która może być używana przez dowolną liczbę kontrolek, które obsługują maskowanie, takie jak kontrolka MaskedTextBox .

public ref class MaskedTextProvider : ICloneable
public class MaskedTextProvider : ICloneable
type MaskedTextProvider = class
    interface ICloneable
Public Class MaskedTextProvider
Implements ICloneable
Dziedziczenie
MaskedTextProvider
Implementuje

Uwagi

Kontrolka MaskedTextBox zawiera maskę składającą się z znaków literałów i elementów formatowania, względem których testuje wszystkie dane wejściowe użytkownika. Zamiast trwale skojarzyć określony aparat analizy maski z MaskedTextBox, Windows Forms udostępnia go jako oddzielną usługę reprezentowaną przez MaskedTextProvider klasę, która definiuje składnię języka maskowania omówionego w dokumentacji właściwościMask.

Wiele elementów członkowskich MaskedTextBox klasy odwołuje się do implementacji podobnie nazwanych elementów członkowskich skojarzonej MaskedTextProviderklasy . Na przykład MaskedTextBox.PromptChar właściwość MaskedTextBox klasy odwołuje się do wszystkich dostępu do PromptCharMaskedTextProvider klasy .

Aparat analizowania maski używany przez MaskedTextProvider program jest modelowany po kontrolce Masked Edit dołączonej do programu Microsoft Visual Basic w wersji 6. Jego język maskowania został opisany w dokumentacji właściwości Mask .

Następujące trzy odrębne ciągi są związane z klasą MaskedTextProvider .

Nazwa ciągu Opis
Znak wejściowy lub ciąg Reprezentuje znaki używane jako dane wejściowe, względem których jest stosowana maska. W rzeczywistości ciąg wejściowy może składać się z wielu operacji wejściowych, w tym Add, Replace, InsertAti Remove. W związku z tym nie można uzyskać bezpośredniego dostępu do ciągu wejściowego. Jednak aspekty obsługi ciągów wejściowych są dostępne, choć właściwości AllowPromptAsInput i AsciiOnly, ResetOnPrompti ResetOnSpace .
Maska Reprezentuje maskę formatowania danych wejściowych używaną do przekształcania ciągu wejściowego w sformatowany ciąg. Ten ciąg jest ustawiany w obiekcie MaskedTextProvider i używany głównie przez Mask właściwość . Cechy maski są również dostępne za pośrednictwem innych elementów członkowskich, takich jak Length, PasswordChari PromptChar właściwości.
Sformatowany ciąg Reprezentuje ciąg, który powoduje zastosowanie pełnej maski do ciągu wejściowego. Sformatowany ciąg może być odpytywane z wieloma elementami członkowskimi klasy, w tym Item[], Length, MaskFullLastAssignedPosition, MaskCompleted, , FindEditPositionFromi tak dalej. Pełna wartość sformatowanego ciągu jest dostępna z ToDisplayString metod i ToString .

Uwaga

Ciąg wejściowy może reprezentować bezpośrednie dane wejściowe użytkownika, tak jak w przypadku MaskedTextBox, lub może być generowany przez inne procesy, które nie są bezpośrednio skojarzone z operacjami wejściowymi/wyjściowymi użytkownika.

Konstruktory

MaskedTextProvider(String)

Inicjuje MaskedTextProvider nowe wystąpienie klasy przy użyciu określonej maski.

MaskedTextProvider(String, Boolean)

Inicjuje MaskedTextProvider nowe wystąpienie klasy przy użyciu określonej maski i wartości ograniczenia ASCII.

MaskedTextProvider(String, Char, Boolean)

Inicjuje MaskedTextProvider nowe wystąpienie klasy przy użyciu określonej maski, znaku hasła i wartości użycia monitu.

MaskedTextProvider(String, CultureInfo)

Inicjuje MaskedTextProvider nowe wystąpienie klasy przy użyciu określonej maski i kultury.

MaskedTextProvider(String, CultureInfo, Boolean)

Inicjuje MaskedTextProvider nowe wystąpienie klasy przy użyciu określonej maski, kultury i wartości ograniczenia ASCII.

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

Inicjuje nowe wystąpienie MaskedTextProvider klasy przy użyciu określonej maski, kultury, wartości użycia monitu, znaku monitu, znaku hasła i wartości ograniczenia ASCII.

MaskedTextProvider(String, CultureInfo, Char, Boolean)

Inicjuje MaskedTextProvider nowe wystąpienie klasy przy użyciu określonej maski, kultury, znaku hasła i wartości użycia monitu.

Właściwości

AllowPromptAsInput

Pobiera wartość wskazującą, czy znak monitu powinien być traktowany jako prawidłowy znak wejściowy, czy nie.

AsciiOnly

Pobiera wartość wskazującą, czy maska akceptuje znaki poza zestawem znaków ASCII.

AssignedEditPositionCount

Pobiera liczbę pozycji znaków edytowalnych, które zostały już pomyślnie przypisane do wartości wejściowej.

AvailableEditPositionCount

Pobiera liczbę pozycji znaków edytowalnych w masce wejściowej, które nie zostały jeszcze przypisane do wartości wejściowej.

Culture

Pobiera kulturę, która określa wartość zlokalizowanych separatorów i symboli zastępczych w masce wejściowej.

DefaultPasswordChar

Pobiera domyślny znak hasła używany zasłoniętych danych wejściowych użytkownika.

EditPositionCount

Pobiera liczbę pozycji edytowalnych w sformatowanym ciągu.

EditPositions

Pobiera nowo utworzony moduł wyliczający dla pozycji edytowalnych w sformatowanym ciągu.

IncludeLiterals

Pobiera lub ustawia wartość wskazującą, czy znaki literału w masce wejściowej powinny być uwzględnione w sformatowanym ciągu.

IncludePrompt

Pobiera lub ustawia wartość wskazującą, czy PromptChar jest używana do reprezentowania braku danych wejściowych użytkownika podczas wyświetlania sformatowanego ciągu.

InvalidIndex

Pobiera górną granicę zakresu nieprawidłowych indeksów.

IsPassword

Pobiera lub ustawia wartość określającą, czy należy zastosować ochronę haseł do sformatowanego ciągu.

Item[Int32]

Pobiera element na określonej pozycji w sformatowanych ciągach.

LastAssignedPosition

Pobiera indeks w masce najbardziej prawego znaku wejściowego, który został przypisany do maski.

Length

Pobiera długość maski, bez żadnych znaków modyfikatora maski.

Mask

Pobiera maskę wprowadzania.

MaskCompleted

Pobiera wartość wskazującą, czy wszystkie wymagane dane wejściowe zostały wprowadzone do sformatowanego ciągu.

MaskFull

Pobiera wartość wskazującą, czy wszystkie wymagane i opcjonalne dane wejściowe zostały wprowadzone do sformatowanego ciągu.

PasswordChar

Pobiera lub ustawia znak, który ma zostać zastąpiony rzeczywistymi znakami wejściowymi.

PromptChar

Pobiera lub ustawia znak używany do reprezentowania braku danych wejściowych użytkownika dla wszystkich dostępnych pozycji edycji.

ResetOnPrompt

Pobiera lub ustawia wartość określającą sposób obsługi znaku wejściowego zgodnego z znakiem monitu.

ResetOnSpace

Pobiera lub ustawia wartość określającą sposób obsługi znaku wejściowego spacji.

SkipLiterals

Pobiera lub ustawia wartość wskazującą, czy pozycje znaków literału w masce można zastąpić tymi samymi wartościami.

Metody

Add(Char)

Dodaje określony znak wejściowy na końcu sformatowanego ciągu.

Add(Char, Int32, MaskedTextResultHint)

Dodaje określony znak wejściowy na końcu sformatowanego ciągu, a następnie zwraca położenie i opisowe informacje.

Add(String)

Dodaje znaki w określonym ciągu wejściowym na końcu sformatowanego ciągu.

Add(String, Int32, MaskedTextResultHint)

Dodaje znaki w określonym ciągu wejściowym na końcu sformatowanego ciągu, a następnie zwraca położenie i opisowe informacje.

Clear()

Czyści wszystkie edytowalne znaki wejściowe z sformatowanego ciągu, zastępując je znakami monitu.

Clear(MaskedTextResultHint)

Czyści wszystkie edytowalne znaki wejściowe z sformatowanego ciągu, zastępując je znakami monitu, a następnie wyświetla opisowe informacje.

Clone()

Tworzy kopię bieżącego MaskedTextProviderelementu .

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
FindAssignedEditPositionFrom(Int32, Boolean)

Zwraca pozycję pierwszego przypisanego położenia edytowalnego po określonej pozycji przy użyciu określonego kierunku wyszukiwania.

FindAssignedEditPositionInRange(Int32, Int32, Boolean)

Zwraca pozycję pierwszego przypisanego położenia edytowalnego między określonymi pozycjami przy użyciu określonego kierunku wyszukiwania.

FindEditPositionFrom(Int32, Boolean)

Zwraca pozycję pierwszej pozycji edytowalnej po określonej pozycji przy użyciu określonego kierunku wyszukiwania.

FindEditPositionInRange(Int32, Int32, Boolean)

Zwraca pozycję pierwszej pozycji edytowalnej między określonymi pozycjami przy użyciu określonego kierunku wyszukiwania.

FindNonEditPositionFrom(Int32, Boolean)

Zwraca pozycję pierwszego położenia nieedytowalnego po określonej pozycji przy użyciu określonego kierunku wyszukiwania.

FindNonEditPositionInRange(Int32, Int32, Boolean)

Zwraca pozycję pierwszego nieedytowalnego położenia między określonymi pozycjami przy użyciu określonego kierunku wyszukiwania.

FindUnassignedEditPositionFrom(Int32, Boolean)

Zwraca pozycję pierwszego nieprzypisanego położenia edytowalnego po określonej pozycji przy użyciu określonego kierunku wyszukiwania.

FindUnassignedEditPositionInRange(Int32, Int32, Boolean)

Zwraca położenie pierwszej nieprzypisanej pozycji edytowalnej między określonymi pozycjami przy użyciu określonego kierunku wyszukiwania.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetOperationResultFromHint(MaskedTextResultHint)

Określa, czy określony MaskedTextResultHint wskazuje powodzenie lub niepowodzenie.

GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
InsertAt(Char, Int32)

Wstawia określony znak na określonej pozycji w sformatowanych ciągach.

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Wstawia określony znak w określonym położeniu w sformatowanych ciągach, zwracając ostatnią pozycję wstawiania i stan operacji.

InsertAt(String, Int32)

Wstawia określony ciąg na określonej pozycji w sformatowanym ciągu.

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Wstawia określony ciąg na określonej pozycji w sformatowanym ciągu, zwracając ostatnią pozycję wstawiania i stan operacji.

IsAvailablePosition(Int32)

Określa, czy określona pozycja jest dostępna dla przypisania.

IsEditPosition(Int32)

Określa, czy określona pozycja jest edytowalna.

IsValidInputChar(Char)

Określa, czy określony znak jest prawidłowym znakiem wejściowym.

IsValidMaskChar(Char)

Określa, czy określony znak jest prawidłowym znakiem maski.

IsValidPasswordChar(Char)

Określa, czy określony znak jest prawidłowym znakiem hasła.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
Remove()

Usuwa ostatni przypisany znak z sformatowanego ciągu.

Remove(Int32, MaskedTextResultHint)

Usuwa ostatni przypisany znak z sformatowanego ciągu, a następnie zwraca pozycję usuwania i informacje opisowe.

RemoveAt(Int32)

Usuwa przypisany znak na określonej pozycji z sformatowanego ciągu.

RemoveAt(Int32, Int32)

Usuwa przypisane znaki między określonymi pozycjami z sformatowanego ciągu.

RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)

Usuwa przypisane znaki między określonymi pozycjami z sformatowanego ciągu, a następnie zwraca pozycję usuwania i informacje opisowe.

Replace(Char, Int32)

Zamienia pojedynczy znak na lub poza określoną pozycję na określoną wartość znaku.

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

Zamienia pojedynczy znak między określonymi pozycjami początkowymi i końcowymi na określoną wartość znaku, a następnie zwraca pozycję usuwania i informacje opisowe.

Replace(Char, Int32, Int32, MaskedTextResultHint)

Zamienia pojedynczy znak na określoną pozycję lub poza określoną wartością znaku, a następnie zwraca pozycję usuwania i opisowe informacje.

Replace(String, Int32)

Zamienia zakres znaków edytowalnych rozpoczynający się na określonej pozycji określonym ciągiem.

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

Zamienia zakres znaków edytowalnych między określonymi pozycjami początkowymi i końcowymi określonym ciągiem, a następnie zwraca położenie usuwania i informacje opisowe.

Replace(String, Int32, Int32, MaskedTextResultHint)

Zamienia zakres znaków edytowalnych rozpoczynający się na określonej pozycji określonym ciągiem, a następnie zwraca położenie usuwania i opisowe informacje.

Set(String)

Ustawia sformatowany ciąg na określony ciąg wejściowy.

Set(String, Int32, MaskedTextResultHint)

Ustawia sformatowany ciąg na określony ciąg wejściowy, a następnie generuje pozycję usuwania i informacje opisowe.

ToDisplayString()

Zwraca sformatowany ciąg w postaci wyświetlanej.

ToString()

Zwraca sformatowany ciąg, który zawiera wszystkie przypisane wartości znaków.

ToString(Boolean)

Zwraca sformatowany ciąg, opcjonalnie zawierający znaki hasła.

ToString(Boolean, Boolean)

Zwraca sformatowany ciąg, opcjonalnie w tym znaki monitu i literału.

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

Zwraca podciąg sformatowanego ciągu, opcjonalnie łącznie z znakami monitu, literału i hasła.

ToString(Boolean, Boolean, Int32, Int32)

Zwraca podciąg sformatowanego ciągu, opcjonalnie w tym znaki monitu i literału.

ToString(Boolean, Int32, Int32)

Zwraca podciąg sformatowanego ciągu, opcjonalnie w tym znaki hasła.

ToString(Int32, Int32)

Zwraca podciąg sformatowanego ciągu.

VerifyChar(Char, Int32, MaskedTextResultHint)

Sprawdza, czy określony znak można ustawić pomyślnie na określonej pozycji.

VerifyEscapeChar(Char, Int32)

Sprawdza, czy określony znak zostanie uniknięty w określonej pozycji.

VerifyString(String)

Sprawdza, czy określony ciąg może zostać pomyślnie ustawiony.

VerifyString(String, Int32, MaskedTextResultHint)

Sprawdza, czy określony ciąg można ustawić pomyślnie, a następnie zwraca pozycje i informacje opisowe.

Dotyczy

Zobacz też