Beispiel für das MaskedTextBox-Steuerelement

Aktualisiert: November 2007

Im Beispiel zum MaskedTextBox-Steuerelement wird die Verwendung mehrerer normaler und erweiterter Features des Steuerelements veranschaulicht. Zu diesen Features gehört das Definieren von Masken, das Überprüfen von Benutzereingaben und das Hinzufügen neuer Maskendefinitionen im Eingabeformat-Editor von Visual Studio.

Informationen zur Verwendung der Beispiele finden Sie unter den folgenden Themen:

Sicherheitshinweis:

Dieser Beispielcode soll ein Konzept veranschaulichen und nicht in Anwendungen oder Websites verwendet werden, da er möglicherweise nicht die sichersten Programmierpraktiken darstellt. Microsoft übernimmt keine Haftung für zufällig entstandene oder Folgeschäden durch die Verwendung des Beispielcodes für einen anderen als den vorgesehenen Zweck.

Veranschaulicht die wichtigsten Features dieses Steuerelements.

So können Sie das Beispiel über die Eingabeaufforderung erstellen und ausführen

  1. Navigieren Sie an der Eingabeaufforderung zum Speicherort der unkomprimierten Beispieldateien.

  2. Navigieren Sie zu einem der sprachspezifischen Unterverzeichnisse im Verzeichnis MaskedTextBoxSample.

  3. Geben Sie msbuild ein, um das Beispiel mit der bereitgestellten Projektmappendatei (.sln) zu erstellen.

  4. Geben Sie cd MaskedTextBox\bin\Debug ein, um zum Speicherort der ausführbaren Datei zu navigieren.

  5. Geben Sie MaskedTextBoxSample.exe ein, um das Beispiel auszuführen.

So können Sie das Beispiel in Visual Studio erstellen und ausführen

  1. Navigieren Sie in Windows Explorer zum Speicherort der unkomprimierten Beispieldateien.

  2. Navigieren Sie zu einem der sprachspezifischen Unterverzeichnisse im Verzeichnis MaskedTextBoxSample.

  3. Doppelklicken Sie auf die Projektmappendatei (.sln), um diese in Visual Studio zu öffnen.

  4. Drücken Sie F5 in Visual Studio, um das Beispiel zu erstellen und auszuführen.

So verwenden Sie MaskedTextBoxSample

  1. Geben Sie im MaskedTextBox verschiedene Arten von IP-Adressen ein, und achten Sie darauf was geschieht, insbesondere wenn Sie ungültige Adressen wie 300.300.300.300 eingeben.

  2. Mithilfe der verschiedenen Kontrollkästchenoptionen können Sie die Ausgabe der Text-Eigenschaft des MaskedTextBox-Steuerelements steuern.

Veranschaulicht

  • Steuern der Textausgabe des Steuerelements mit der TextMaskFormat-Eigenschaft und der CutCopyMaskFormat-Eigenschaft.

  • Steuern, wie und wann die Eingabeaufforderung für Masken angezeigt wird, mit der PromptChar-Eigenschaft und der HidePromptOnLeave-Eigenschaft

  • Definieren einer benutzerdefinierten Maske für IPv5-Adressen und Einfügen dieser benutzerdefinierten Maske in den Eingabeformat-Editor von Visual Studio mithilfe der MaskDescriptor-Klasse.

  • Definieren eines benutzerdefinierten Datentyps für IPv5-Adressen, die als Argument an die ValidatingType-Eigenschaft des Steuerelements übergeben werden können.

  • Behandeln des TypeValidationCompleted-Ereignisses, wenn der Text im Steuerelement nicht anhand des ValidatingType überprüft werden kann.

  • Konvertieren der Zeichenfolge im MaskedTextBox-Steuerelement in eine Instanz der IPv5-Klasse.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Arbeiten mit dem MaskedTextBox-Steuerelement

Gewusst wie: Binden von Daten an das MaskedTextBox-Steuerelement

Referenz

MaskedTextBox

Weitere Ressourcen

Beispiele für Steuerelemente für Windows Forms