MaskedTextProvider Klasa
Definicja
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ę 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. |