MaskedTextProvider Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.ComponentModel

Zestaw:: System.ComponentModel.TypeConverter.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Źródło:: MaskedTextProvider.cs

Źródło:: MaskedTextProvider.cs

Źródło:: MaskedTextProvider.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje usługę do 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: Object
MaskedTextProvider

Implementuje: ICloneable

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 PromptChar MaskedTextProvider klasy .

Aparat analizowania maski używany przez MaskedTextProvider program jest modelowany po kontrolce Masked Edit uwzględnionej w programie 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, , InsertAt Replacei 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ć AllowPromptAsInput właściwości 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 MaskedTextProvider obiekcie i dostępny przede wszystkim dla Mask właściwości . 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żna odpytować z wieloma elementami członkowskimi klasy, w tym Item[], Length, LastAssignedPosition, MaskFull, 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, ponieważ w przypadku MaskedTextBoxelementu 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