MaskedTextProvider Klasse

Referenz

Definition

Namespace:: System.ComponentModel

Assembly:: System.ComponentModel.TypeConverter.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: MaskedTextProvider.cs

Quelle:: MaskedTextProvider.cs

Quelle:: MaskedTextProvider.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt einen Maskenanalysedienst dar, der von einer beliebigen Anzahl von Steuerelementen, die Maskierung unterstützen, verwendet werden kann, z. B. dem MaskedTextBox-Steuerelement.

public ref class MaskedTextProvider : ICloneable

public class MaskedTextProvider : ICloneable

type MaskedTextProvider = class
    interface ICloneable

Public Class MaskedTextProvider
Implements ICloneable

Vererbung: Object
MaskedTextProvider

Implementiert: ICloneable

Hinweise

Das MaskedTextBox Steuerelement enthält eine Maske, die aus Literalzeichen und Formatierungselementen besteht und mit der alle Benutzereingaben getestet werden. Anstatt eine bestimmte Maskenanalyse-Engine dauerhaft mit MaskedTextBoxzu verknüpfen, stellt Windows Forms sie als separaten Dienst bereit, der durch die MaskedTextProvider -Klasse dargestellt wird, die die Syntax der Maskierungssprache definiert, die in der Dokumentation für die Mask -Eigenschaft beschrieben wird.

Viele Member der MaskedTextBox -Klasse verweisen auf ihre Implementierung auf ähnlich benannte Member des zugeordneten MaskedTextProvider. Die -Eigenschaft der MaskedTextBox -Klasse verweist beispielsweise MaskedTextBox.PromptChar auf den gesamten Zugriff auf die PromptChar der MaskedTextProvider -Klasse.

Die von MaskedTextProvider verwendete Maskenanalyse-Engine wird nach dem Steuerelement Masked Edit modelliert, das in Microsoft Visual Basic Version 6 enthalten ist. Die Maskierungssprache wird in der Dokumentation für die Mask -Eigenschaft beschrieben.

Die folgenden drei unterschiedlichen Zeichenfolgen sind an der MaskedTextProvider -Klasse beteiligt.

Zeichenfolgenname	BESCHREIBUNG
Eingabezeichen oder -zeichenfolge	Stellt die Zeichen dar, die als Eingabe verwendet werden, für die die Maske angewendet wird. In der Tatsächlichkeit kann die Eingabezeichenfolge aus mehreren Eingabevorgängen bestehen, einschließlich Add, Replace, InsertAtund Remove. Daher kann nicht direkt auf die Eingabezeichenfolge zugegriffen werden. Aspekte der Verarbeitung von Eingabezeichenfolgen sind jedoch über die AllowPromptAsInput Eigenschaften und AsciiOnly, ResetOnPromptund ResetOnSpace verfügbar.
Mask	Stellt die Eingabeformatierungsmaske dar, die zum Transformieren der Eingabezeichenfolge in die formatierte Zeichenfolge verwendet wird. Diese Zeichenfolge wird in festgelegt MaskedTextProvider und in erster Linie über die Mask -Eigenschaft aufgerufen. Merkmale der Maske sind auch über andere Member verfügbar, z. B. die LengthEigenschaften , PasswordCharund PromptChar .
Formatierte Zeichenfolge	Stellt die Zeichenfolge dar, die sich ergibt, wenn die vollständige Maske auf die Eingabezeichenfolge angewendet wird. Die formatierte Zeichenfolge kann mit vielen Membern der -Klasse abgefragt werden, einschließlich Item[], Length, LastAssignedPosition, MaskFull, MaskCompleted FindEditPositionFrom, usw. Der vollständige Wert der formatierten Zeichenfolge ist über die ToDisplayString Methoden und ToString verfügbar.

Hinweis

Die Eingabezeichenfolge kann direkte Benutzereingaben darstellen, wie im Fall von , oder kann von anderen Prozessen generiert werden, die MaskedTextBoxnicht direkt mit Benutzereingabe-/Ausgabevorgängen verknüpft sind.

Konstruktoren

MaskedTextProvider(String)	Initialisiert eine neue Instanz der MaskedTextProvider-Klasse unter Verwendung der angegebenen Maske.
MaskedTextProvider(String, Boolean)	Initialisiert eine neue Instanz der MaskedTextProvider-Klasse unter Verwendung der angegebenen Maske und des angegebenen ASCII-Einschränkungswerts.
MaskedTextProvider(String, Char, Boolean)	Initialisiert unter Verwendung der angegebenen Maske, des angegebenen Kennwortzeichens und des Aufforderungsverwendungswerts eine neue Instanz der MaskedTextProvider-Klasse.
MaskedTextProvider(String, CultureInfo)	Initialisiert eine neue Instanz der MaskedTextProvider-Klasse unter Verwendung der angegebenen Maske und der angegebenen Kultur.
MaskedTextProvider(String, CultureInfo, Boolean)	Initialisiert eine neue Instanz der MaskedTextProvider-Klasse unter Verwendung der angegebenen Maske und Kultur sowie des angegebenen ASCII-Einschränkungswerts.
MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean)	Initialisiert unter Verwendung der angegebenen Maske und Kultur, des angegebenen Aufforderungsverwendungswerts, des Kennwortzeichens und des ASCII-Einschränkungswerts eine neue Instanz der MaskedTextProvider-Klasse.
MaskedTextProvider(String, CultureInfo, Char, Boolean)	Initialisiert unter Verwendung der angegebenen Maske und Kultur, des angegebenen Kennwortzeichens und des Aufforderungsverwendungswerts eine neue Instanz der MaskedTextProvider-Klasse.

Eigenschaften

AllowPromptAsInput	Ruft einen Wert ab, der angibt, ob das Aufforderungszeichen als gültiges Eingabezeichen behandelt werden soll.
AsciiOnly	Ruft einen Wert ab, der angibt, ob die Maske Zeichen akzeptiert, die nicht dem ASCII-Zeichensatz angehören.
AssignedEditPositionCount	Ruft die Anzahl von bearbeitbaren Zeichenpositionen ab, denen bereits erfolgreich ein Eingabewert zugewiesen wurde.
AvailableEditPositionCount	Ruft die Anzahl der bearbeitbaren Zeichenpositionen in der Eingabemaske ab, denen bisher noch kein Eingabewert zugewiesen wurde.
Culture	Ruft die Kultur ab, die den Wert der lokalisierbaren Trennzeichen und Platzhalter in der Eingabemaske bestimmt.
DefaultPasswordChar	Ruft das zur Verdeckung von Benutzereingaben verwendete Standardkennwortzeichen ab.
EditPositionCount	Ruft die Anzahl der bearbeitbaren Positionen in der formatierten Zeichenfolge ab.
EditPositions	Ruft einen neu erstellten Enumerator für die bearbeitbaren Positionen in der formatierten Zeichenfolge ab.
IncludeLiterals	Ruft einen Wert ab, der angibt, ob in der Eingabemaske vorhandene Literalzeichen in die formatierte Zeichenfolge aufgenommen werden, oder legt diesen Wert fest.
IncludePrompt	Ruft einen Wert ab, der angibt, ob mithilfe von PromptChar bei der Anzeige der formatierten Zeichenfolge das Nichtvorhandensein von Benutzereingaben angegeben wird, oder legt diesen Wert fest.
InvalidIndex	Ruft die Obergrenze des ungültigen Indexbereichs ab.
IsPassword	Ruft einen Wert ab, der bestimmt, ob auf die formatierte Zeichenfolge Kennwortschutz angewendet werden soll, oder legt einen solchen Wert fest.
Item[Int32]	Ruft das Element an der angegebenen Position in der formatierten Zeichenfolge ab.
LastAssignedPosition	Ruft in der Maske den Index des ganz rechts stehenden, der Maske zugeordneten Eingabezeichens ab.
Length	Ruft die Länge der Maske ohne Maskenmodifiziererzeichen ab.
Mask	Ruft die Eingabemaske ab.
MaskCompleted	Ruft einen Wert ab, der angibt, ob in der formatierten Zeichenfolge alle erforderlichen Eingaben erfolgt sind.
MaskFull	Ruft einen Wert ab, der angibt, ob in der formatierten Zeichenfolge alle erforderlichen und optionalen Eingaben erfolgt sind.
PasswordChar	Ruft das Zeichen ab, das das eigentliche Eingabezeichen ersetzen soll, oder legt dieses fest.
PromptChar	Ruft das Zeichen ab, mit dem das Nichtvorhandensein von Benutzereingaben für alle verfügbaren Bearbeitungspositionen dargestellt wird, oder legt dieses Zeichen fest.
ResetOnPrompt	Ruft einen Wert ab, der bestimmt, wie ein dem Aufforderungszeichen entsprechendes Eingabezeichen behandelt werden soll, oder legt diesen Wert fest.
ResetOnSpace	Ruft einen Wert ab, der bestimmt, wie ein eingegebenes Leerzeichen zu behandeln ist, oder legt diesen Wert fest.
SkipLiterals	Ruft einen Wert ab, der angibt, ob Literalzeichenpositionen in der Maske durch ihnen entsprechende Werte überschrieben werden dürfen, oder legt einen solchen Wert fest.

Methoden

Add(Char)	Fügt das angegebene Eingabezeichen am Ende der formatierten Zeichenfolge hinzu.
Add(Char, Int32, MaskedTextResultHint)	Fügt das angegebene Eingabezeichen am Ende der formatierten Zeichenfolge hinzu und gibt dann Positions- und beschreibende Informationen aus.
Add(String)	Fügt die Zeichen aus der angegebenen Eingabezeichenfolge am Ende der formatierten Zeichenfolge hinzu.
Add(String, Int32, MaskedTextResultHint)	Fügt die Zeichen aus der angegebenen Eingabezeichenfolge am Ende der formatierten Zeichenfolge hinzu und gibt dann Positions- und beschreibende Informationen aus.
Clear()	Löscht alle bearbeitbaren Eingabezeichen aus der formatierten Zeichenfolge und ersetzt sie durch Aufforderungszeichen.
Clear(MaskedTextResultHint)	Löscht alle bearbeitbaren Eingabezeichen aus der formatierten Zeichenfolge, ersetzt sie durch Aufforderungszeichen und gibt dann beschreibende Informationen aus.
Clone()	Erstellt eine Kopie der aktuellen MaskedTextProvider.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FindAssignedEditPositionFrom(Int32, Boolean)	Gibt die Position der ersten zugewiesenen bearbeitbaren Position nach der angegebenen Position in der angegebenen Suchrichtung zurück.
FindAssignedEditPositionInRange(Int32, Int32, Boolean)	Gibt die Position der ersten zugewiesenen bearbeitbaren Position zwischen den angegebenen Positionen in der angegebenen Suchrichtung zurück.
FindEditPositionFrom(Int32, Boolean)	Gibt die Position der ersten bearbeitbaren Position nach der angegebenen Position in der angegebenen Suchrichtung zurück.
FindEditPositionInRange(Int32, Int32, Boolean)	Gibt die Position der ersten bearbeitbaren Position zwischen den angegebenen Positionen in der angegebenen Suchrichtung zurück.
FindNonEditPositionFrom(Int32, Boolean)	Gibt die Position der ersten nicht-bearbeitbaren Position nach der angegebenen Position in der angegebenen Suchrichtung zurück.
FindNonEditPositionInRange(Int32, Int32, Boolean)	Gibt die Position der ersten nicht-bearbeitbaren Position zwischen den angegebenen Positionen in der angegebenen Suchrichtung zurück.
FindUnassignedEditPositionFrom(Int32, Boolean)	Gibt die Position der ersten nicht zugewiesenen bearbeitbaren Position nach der angegebenen Position in der angegebenen Suchrichtung zurück.
FindUnassignedEditPositionInRange(Int32, Int32, Boolean)	Gibt die Position der ersten nicht zugewiesenen bearbeitbaren Position zwischen den angegebenen Positionen in der angegebenen Suchrichtung zurück.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetOperationResultFromHint(MaskedTextResultHint)	Bestimmt, ob der angegebene MaskedTextResultHint einen Erfolg oder ein Fehlschlagen anzeigt.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InsertAt(Char, Int32)	Fügt das angegebene Zeichen an der angegebenen Position innerhalb der formatierten Zeichenfolge ein.
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	Fügt das angegebene Zeichen an der angegebenen Position innerhalb der formatierten Zeichenfolge ein und gibt die letzte Einfügeposition sowie den Status des Vorgangs zurück.
InsertAt(String, Int32)	Fügt die angegebene Zeichenfolge an einer angegebenen Position innerhalb der formatierten Zeichenfolge ein.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Fügt die angegebene Zeichenfolge an einer angegebenen Position innerhalb der formatierten Zeichenfolge ein und gibt die letzte Einfügeposition sowie den Status des Vorgangs zurück.
IsAvailablePosition(Int32)	Bestimmt, ob die angegebene Position zugewiesen werden kann.
IsEditPosition(Int32)	Bestimmt, ob die angegebene Position bearbeitbar ist.
IsValidInputChar(Char)	Bestimmt, ob das angegebene Zeichen ein gültiges Eingabezeichen ist.
IsValidMaskChar(Char)	Bestimmt, ob das angegebene Zeichen ein gültiges Maskenzeichen ist.
IsValidPasswordChar(Char)	Bestimmt, ob das angegebene Zeichen ein gültiges Kennwortzeichen ist.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove()	Entfernt das zuletzt zugewiesene Zeichen aus der formatierten Zeichenfolge.
Remove(Int32, MaskedTextResultHint)	Entfernt das zuletzt zugewiesene Zeichen aus der formatierten Zeichenfolge und gibt dann die Löschposition sowie beschreibende Informationen aus.
RemoveAt(Int32)	Entfernt das zugewiesene Zeichen an der angegebenen Position aus der formatierten Zeichenfolge.
RemoveAt(Int32, Int32)	Entfernt die zugewiesenen Zeichen zwischen den angegebenen Positionen aus der formatierten Zeichenfolge.
RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)	Entfernt die zwischen den angegebenen Positionen zugewiesenen Zeichen aus der formatierten Zeichenfolge und gibt dann die Löschposition sowie beschreibende Informationen aus.
Replace(Char, Int32)	Ersetzt ein einzelnes Zeichen an oder hinter der angegebenen Position durch den angegebenen Zeichenwert.
Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)	Ersetzt ein einzelnes Zeichen zwischen der angegebenen Anfangs- und Endposition durch den angegebenen Zeichenwert und gibt dann die Löschposition sowie beschreibende Informationen aus.
Replace(Char, Int32, Int32, MaskedTextResultHint)	Ersetzt ein einzelnes Zeichen an oder hinter der angegebenen Position durch den angegebenen Zeichenwert und gibt dann die Löschposition sowie beschreibende Informationen aus.
Replace(String, Int32)	Ersetzt einen Bereich bearbeitbarer Zeichen und beginnt dabei an der angegebenen Position sowie mit der angegebenen Zeichenfolge.
Replace(String, Int32, Int32, Int32, MaskedTextResultHint)	Ersetzt einen Bereich bearbeitbarer Zeichen zwischen der angegebenen Anfangs- und Endposition durch die angegebene Zeichenfolge und gibt dann die Löschposition sowie beschreibende Informationen aus.
Replace(String, Int32, Int32, MaskedTextResultHint)	Ersetzt einen Bereich bearbeitbarer Zeichen beginnend an der angegebenen Position und mit der angegebenen Zeichenfolge und gibt dann die Löschposition sowie beschreibende Informationen aus.
Set(String)	Legt die formatierte Zeichenfolge auf die angegebene Eingabezeichenfolge fest.
Set(String, Int32, MaskedTextResultHint)	Legt die formatierte Zeichenfolge auf die angegebene Eingabezeichenfolge fest und gibt anschließend die Löschposition sowie beschreibende Informationen aus.
ToDisplayString()	Gibt die formatierte Zeichenfolge in anzeigbarer Form zurück.
ToString()	Gibt die formatierte Zeichenfolge zurück, die alle zugewiesenen Zeichenwerte umfasst.
ToString(Boolean)	Gibt die formatierte Zeichenfolge (optional einschließlich von Kennwortzeichen) zurück.
ToString(Boolean, Boolean)	Gibt die formatierte Zeichenfolge (optional einschließlich Aufforderungs- und Literalzeichen) zurück.
ToString(Boolean, Boolean, Boolean, Int32, Int32)	Gibt eine Teilzeichenfolge der formatierten Zeichenfolge (optional einschließlich Aufforderungs-, Literal- und Kennwortzeichen) zurück.
ToString(Boolean, Boolean, Int32, Int32)	Gibt eine Teilzeichenfolge der formatierten Zeichenfolge (optional einschließlich Aufforderungs- und Literalzeichen) zurück.
ToString(Boolean, Int32, Int32)	Gibt eine Teilzeichenfolge der formatierten Zeichenfolge (optional einschließlich von Kennwortzeichen) zurück.
ToString(Int32, Int32)	Gibt eine Teilzeichenfolge der formatierten Zeichenfolge zurück.
VerifyChar(Char, Int32, MaskedTextResultHint)	Prüft, ob das angegebene Zeichen erfolgreich an der angegebenen Position festgelegt werden konnte.
VerifyEscapeChar(Char, Int32)	Prüft, ob das angegebene Zeichen an der angegebenen Position mit Escapezeichen versehen werden würde.
VerifyString(String)	Prüft, ob die angegebene Zeichenfolge erfolgreich festgelegt werden konnte.
VerifyString(String, Int32, MaskedTextResultHint)	Prüft, ob die angegebene Zeichenfolge erfolgreich festgelegt werden konnte, und gibt dann die Position und beschreibende Informationen aus.

Gilt für: