MaskedTextProvider Klasse
Definition
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 verwendet werden kann, die die Maskierung unterstützen, z. B. das MaskedTextBox Steuerelement.
public ref class MaskedTextProvider : ICloneable[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicConstructors)]
public class MaskedTextProvider : ICloneablepublic class MaskedTextProvider : ICloneable[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicConstructors)>]
type MaskedTextProvider = class
interface ICloneabletype MaskedTextProvider = class
interface ICloneablePublic Class MaskedTextProvider
Implements ICloneable- Vererbung
-
MaskedTextProvider
- Attribute
- Implementiert
Hinweise
Das MaskedTextBox Steuerelement enthält eine Maske, die aus Literalzeichen und Formatierungselementen besteht, auf die alle Benutzereingaben überprüft werden. Anstatt ein bestimmtes Maskenanalysemodul dauerhaft zuzuordnen MaskedTextBox, stellt Windows Forms es als separaten Dienst bereit, der durch die MaskedTextProvider Klasse dargestellt wird, wodurch die Syntax der maskierenden Sprache definiert wird, die in der Dokumentation für die Mask Eigenschaft erläutert wird.
Viele mitglieder der MaskedTextBox Klasse verweisen auf ihre Implementierung auf ähnlich benannte Member der zugeordneten MaskedTextProvider. Beispielsweise bezieht sich die MaskedTextBox.PromptChar Eigenschaft der MaskedTextBox Klasse auf den gesamten Zugriff auf die PromptCharMaskedTextProvider Klasse.
Das verwendete MaskedTextProvider Maskenanalysemodul wird nach dem maskierten Bearbeitungssteuerelement 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 mit der MaskedTextProvider Klasse verbunden.
| Zeichenfolgenname | Beschreibung |
|---|---|
| Eingabezeichen oder Zeichenfolge | Stellt die Zeichen dar, die als Eingabe verwendet werden, für die das Format 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 Eingabezeichenfolgenbehandlung sind jedoch verfügbar, obwohl die AllowPromptAsInput und AsciiOnly, ResetOnPromptund die ResetOnSpace Eigenschaften. |
| Maske | Stellt das Eingabeformatformat dar, das zum Transformieren der Eingabezeichenfolge in die formatierte Zeichenfolge verwendet wird. Diese Zeichenfolge wird in erster Linie Mask in der MaskedTextProvider Eigenschaft festgelegt und darauf zugegriffen. Eigenschaften der Maske sind auch über andere Member verfügbar, z. B. die Length, PasswordCharund PromptChar Eigenschaften. |
| Formatierte Zeichenfolge | Stellt die Zeichenfolge dar, die beim Anwenden der vollständigen Maske auf die Eingabezeichenfolge resultiert. Die formatierte Zeichenfolge kann mit vielen Mitgliedern der Klasse abgefragt werden, einschließlich Item[], Length, , LastAssignedPosition, MaskFull, , MaskCompleted, FindEditPositionFromusw. Der vollständige Wert der formatierten Zeichenfolge steht in den ToDisplayString und ToString den Methoden zur Verfügung. |
Hinweis
Die Eingabezeichenfolge kann direkte Benutzereingaben darstellen, wie im Falle der MaskedTextBoxZeichenfolge oder durch andere Prozesse, die nicht direkt mit Benutzereingabe-/Ausgabevorgängen verknüpft sind.
Konstruktoren
| Name | Beschreibung |
|---|---|
| MaskedTextProvider(String, Boolean) |
Initialisiert eine neue Instanz der MaskedTextProvider Klasse mithilfe des angegebenen Masken- und ASCII-Einschränkungswerts. |
| MaskedTextProvider(String, Char, Boolean) |
Initialisiert eine neue Instanz der MaskedTextProvider Klasse mithilfe des angegebenen Masken-, Kennwortzeichen- und Eingabeaufforderungsverwendungswerts. |
| MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean) |
Initialisiert eine neue Instanz der Klasse mithilfe des MaskedTextProvider angegebenen Maskenformats, der Kultur, des Eingabeaufforderungsverwendungswerts, des Eingabeaufforderungszeichens, des Kennwortzeichens und des ASCII-Einschränkungswerts. |
| MaskedTextProvider(String, CultureInfo, Boolean) |
Initialisiert eine neue Instanz der MaskedTextProvider Klasse mithilfe des angegebenen Masken-, Kultur- und ASCII-Einschränkungswerts. |
| MaskedTextProvider(String, CultureInfo, Char, Boolean) |
Initialisiert eine neue Instanz der MaskedTextProvider Klasse mithilfe des angegebenen Masken-, Kultur-, Kennwortzeichen- und Eingabeaufforderungsverwendungswerts. |
| MaskedTextProvider(String, CultureInfo) |
Initialisiert eine neue Instanz der MaskedTextProvider Klasse mithilfe der angegebenen Maske und Kultur. |
| MaskedTextProvider(String) |
Initialisiert eine neue Instanz der MaskedTextProvider Klasse mithilfe des angegebenen Maskenformats. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AllowPromptAsInput |
Ruft einen Wert ab, der angibt, ob das Eingabeaufforderungszeichen als gültiges Eingabezeichen behandelt werden soll oder nicht. |
| AsciiOnly |
Ruft einen Wert ab, der angibt, ob das Format Zeichen außerhalb des ASCII-Zeichensatzes akzeptiert. |
| AssignedEditPositionCount |
Ruft die Anzahl der bearbeitbaren Zeichenpositionen ab, denen bereits ein Eingabewert erfolgreich zugewiesen wurde. |
| AvailableEditPositionCount |
Ruft die Anzahl der bearbeitbaren Zeichenpositionen im Eingabeformat ab, denen noch kein Eingabewert zugewiesen wurde. |
| Culture |
Ruft die Kultur ab, die den Wert der lokalisierbaren Trennzeichen und Platzhalter im Eingabeformat bestimmt. |
| DefaultPasswordChar |
Ruft das standardkennbare Kennwortzeichen ab, das die Benutzereingabe verdeckt. |
| 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 |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Literalzeichen im Eingabeformat in die formatierte Zeichenfolge eingeschlossen werden sollen. |
| IncludePrompt |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob PromptChar das Fehlen von Benutzereingaben beim Anzeigen der formatierten Zeichenfolge verwendet wird. |
| InvalidIndex |
Ruft die obere Grenze des Bereichs ungültiger Indizes ab. |
| IsPassword |
Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob der Kennwortschutz auf die formatierte Zeichenfolge angewendet werden soll. |
| Item[Int32] |
Ruft das Element an der angegebenen Position in der formatierten Zeichenfolge ab. |
| LastAssignedPosition |
Ruft den Index im Format des am weitesten rechts geordneten Eingabezeichens ab, das der Maske zugewiesen wurde. |
| Length |
Ruft die Länge des Maskenformats ab, wobei keine Maskenmodifiziererzeichen vorhanden sind. |
| Mask |
Ruft das Eingabeformat ab. |
| MaskCompleted |
Ruft einen Wert ab, der angibt, ob alle erforderlichen Eingaben in die formatierte Zeichenfolge eingegeben wurden. |
| MaskFull |
Ruft einen Wert ab, der angibt, ob alle erforderlichen und optionalen Eingaben in die formatierte Zeichenfolge eingegeben wurden. |
| PasswordChar |
Dient zum Abrufen oder Festlegen des Zeichens, das durch die tatsächlichen Eingabezeichen ersetzt werden soll. |
| PromptChar |
Dient zum Abrufen oder Festlegen des Zeichens, das verwendet wird, um das Fehlen von Benutzereingaben für alle verfügbaren Bearbeitungspositionen darzustellen. |
| ResetOnPrompt |
Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, wie ein Eingabezeichen, das dem Eingabeaufforderungszeichen entspricht, behandelt werden soll. |
| ResetOnSpace |
Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, wie ein Leerzeichen behandelt werden soll. |
| SkipLiterals |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Literalzeichenpositionen in der Maske durch ihre gleichen Werte überschrieben werden können. |
Methoden
| Name | Beschreibung |
|---|---|
| Add(Char, Int32, MaskedTextResultHint) |
Fügt das angegebene Eingabezeichen am Ende der formatierten Zeichenfolge hinzu und gibt dann Position und beschreibende Informationen aus. |
| Add(Char) |
Fügt das angegebene Eingabezeichen am Ende der formatierten Zeichenfolge hinzu. |
| Add(String, Int32, MaskedTextResultHint) |
Fügt die Zeichen in der angegebenen Eingabezeichenfolge am Ende der formatierten Zeichenfolge hinzu und gibt dann Position und beschreibende Informationen aus. |
| Add(String) |
Fügt die Zeichen in der angegebenen Eingabezeichenfolge am Ende der formatierten Zeichenfolge hinzu. |
| Clear() |
Löscht alle bearbeitbaren Eingabezeichen aus der formatierten Zeichenfolge, und ersetzt sie durch Eingabeaufforderungszeichen. |
| Clear(MaskedTextResultHint) |
Löscht alle bearbeitbaren Eingabezeichen aus der formatierten Zeichenfolge, ersetzt sie durch Eingabeaufforderungszeichen und gibt dann beschreibende Informationen aus. |
| Clone() |
Erstellt eine Kopie der aktuellen MaskedTextProvider. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| FindAssignedEditPositionFrom(Int32, Boolean) |
Gibt die Position der ersten zugewiesenen bearbeitbaren Position nach der angegebenen Position mithilfe der angegebenen Suchrichtung zurück. |
| FindAssignedEditPositionInRange(Int32, Int32, Boolean) |
Gibt die Position der ersten zugewiesenen bearbeitbaren Position zwischen den angegebenen Positionen mithilfe der angegebenen Suchrichtung zurück. |
| FindEditPositionFrom(Int32, Boolean) |
Gibt die Position der ersten bearbeitbaren Position nach der angegebenen Position mithilfe der angegebenen Suchrichtung zurück. |
| FindEditPositionInRange(Int32, Int32, Boolean) |
Gibt die Position der ersten bearbeitbaren Position zwischen den angegebenen Positionen mithilfe der angegebenen Suchrichtung zurück. |
| FindNonEditPositionFrom(Int32, Boolean) |
Gibt die Position der ersten nicht bearbeitbaren Position nach der angegebenen Position mithilfe der angegebenen Suchrichtung zurück. |
| FindNonEditPositionInRange(Int32, Int32, Boolean) |
Gibt die Position der ersten nicht bearbeitbaren Position zwischen den angegebenen Positionen mithilfe der angegebenen Suchrichtung zurück. |
| FindUnassignedEditPositionFrom(Int32, Boolean) |
Gibt die Position der ersten nicht zugewiesenen bearbeitbaren Position nach der angegebenen Position mithilfe der angegebenen Suchrichtung zurück. |
| FindUnassignedEditPositionInRange(Int32, Int32, Boolean) |
Gibt die Position der ersten nicht zugewiesenen bearbeitbaren Position zwischen den angegebenen Positionen mithilfe der angegebenen Suchrichtung zurück. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetOperationResultFromHint(MaskedTextResultHint) |
Bestimmt, ob der angegebene MaskedTextResultHint Wert Erfolg oder Fehler angibt. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| InsertAt(Char, Int32, Int32, MaskedTextResultHint) |
Fügt das angegebene Zeichen an der angegebenen Position in der formatierten Zeichenfolge ein, wobei die letzte Einfügeposition und der Status des Vorgangs zurückgegeben werden. |
| InsertAt(Char, Int32) |
Fügt das angegebene Zeichen an der 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, wobei die letzte Einfügeposition und der Status des Vorgangs zurückgegeben werden. |
| InsertAt(String, Int32) |
Fügt die angegebene Zeichenfolge an einer angegebenen Position innerhalb der formatierten Zeichenfolge ein. |
| IsAvailablePosition(Int32) |
Bestimmt, ob die angegebene Position für die Zuordnung verfügbar ist. |
| 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 der 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 Entfernungsposition und beschreibende Informationen aus. |
| RemoveAt(Int32, Int32, Int32, MaskedTextResultHint) |
Entfernt die zugewiesenen Zeichen zwischen den angegebenen Positionen aus der formatierten Zeichenfolge und gibt dann die Entfernungsposition und beschreibende Informationen aus. |
| RemoveAt(Int32, Int32) |
Entfernt die zugewiesenen Zeichen zwischen den angegebenen Positionen aus der formatierten Zeichenfolge. |
| RemoveAt(Int32) |
Entfernt das zugewiesene Zeichen an der angegebenen Position aus der formatierten Zeichenfolge. |
| Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) |
Ersetzt ein einzelnes Zeichen zwischen den angegebenen Anfangs- und Endpositionen durch den angegebenen Zeichenwert und gibt dann die Entfernungsposition und beschreibende Informationen aus. |
| Replace(Char, Int32, Int32, MaskedTextResultHint) |
Ersetzt ein einzelnes Zeichen an oder über die angegebene Position durch den angegebenen Zeichenwert und gibt dann die Entfernungsposition und beschreibende Informationen aus. |
| Replace(Char, Int32) |
Ersetzt ein einzelnes Zeichen an oder über der angegebenen Position durch den angegebenen Zeichenwert. |
| Replace(String, Int32, Int32, Int32, MaskedTextResultHint) |
Ersetzt einen Bereich bearbeitbarer Zeichen zwischen den angegebenen Anfangs- und Endpositionen durch die angegebene Zeichenfolge und gibt dann die Entfernungsposition und beschreibende Informationen aus. |
| Replace(String, Int32, Int32, MaskedTextResultHint) |
Ersetzt einen Bereich von bearbeitbaren Zeichen beginnend an der angegebenen Position durch die angegebene Zeichenfolge und gibt dann die Entfernungsposition und beschreibende Informationen aus. |
| Replace(String, Int32) |
Ersetzt einen Bereich von bearbeitbaren Zeichen beginnend an der angegebenen Position durch die angegebene Zeichenfolge. |
| Set(String, Int32, MaskedTextResultHint) |
Legt die formatierte Zeichenfolge auf die angegebene Eingabezeichenfolge fest und gibt dann die Entfernungsposition und beschreibende Informationen aus. |
| Set(String) |
Legt die formatierte Zeichenfolge auf die angegebene Eingabezeichenfolge fest. |
| ToDisplayString() |
Gibt die formatierte Zeichenfolge in einer anzeigefähigen Form zurück. |
| ToString() |
Gibt die formatierte Zeichenfolge zurück, die alle zugewiesenen Zeichenwerte enthält. |
| ToString(Boolean, Boolean, Boolean, Int32, Int32) |
Gibt eine Teilzeichenfolge der formatierten Zeichenfolge zurück, optional einschließlich Eingabeaufforderungs-, Literal- und Kennwortzeichen. |
| ToString(Boolean, Boolean, Int32, Int32) |
Gibt eine Teilzeichenfolge der formatierten Zeichenfolge zurück, optional einschließlich Eingabeaufforderungs- und Literalzeichen. |
| ToString(Boolean, Boolean) |
Gibt die formatierte Zeichenfolge zurück, optional einschließlich Eingabeaufforderungs- und Literalzeichen. |
| ToString(Boolean, Int32, Int32) |
Gibt eine Teilzeichenfolge der formatierten Zeichenfolge zurück, optional auch Kennwortzeichen. |
| ToString(Boolean) |
Gibt die formatierte Zeichenfolge zurück, optional einschließlich Kennwortzeichen. |
| ToString(Int32, Int32) |
Gibt eine Teilzeichenfolge der formatierten Zeichenfolge zurück. |
| VerifyChar(Char, Int32, MaskedTextResultHint) |
Überprüft, ob das angegebene Zeichen erfolgreich an der angegebenen Position festgelegt werden kann. |
| VerifyEscapeChar(Char, Int32) |
Überprüft, ob das angegebene Zeichen an der angegebenen Position escaped wäre. |
| VerifyString(String, Int32, MaskedTextResultHint) |
Überprüft, ob die angegebene Zeichenfolge erfolgreich festgelegt werden kann, und gibt dann Position und beschreibende Informationen aus. |
| VerifyString(String) |
Überprüft, ob die angegebene Zeichenfolge erfolgreich festgelegt werden kann. |
