VB.Net TEXTBOX Control Tutorial: Eigenschaften mit Beispiel

⚡ Intelligente Zusammenfassung

TextBox Steuerelemente in VB.NET akzeptieren Benutzereingaben auf einem Windows Eigenschaften wie Multiline, PasswordChar, MaxLength und ReadOnly können definiert und offengelegt werden, um zu steuern, wie Text zur Laufzeit eingegeben, ausgeblendet, begrenzt oder gesperrt wird.

  • 🧩 Hauptzweck: Der TextBox Die Steuerung erfasst ein- oder mehrzeilige Benutzereingaben auf einem Windows Form während der Laufzeit.
  • 🔤 Schlüsseleigenschaften: Die Optionen TextAlign, ScrollBars, Multiline, MaxLength, Readonly und PasswordChar ermöglichen die Anpassung des Steuerelementverhaltens.
  • 🔐 Passwortmaskierung: Die Einstellung PasswordChar auf * blendet Zeichen während der Eingabe aus.ping sensible Daten sind privat.
  • 📄 Mehrere Zeilen: Aktivieren Sie Multiline und verwenden Sie dann ControlChars.NewLine, um den Text auf mehrere Zeilen aufzuteilen.
  • 🔢 Numerische Werte: Konvertiere die Zeichenkette mit Integer.Parse, bevor du Text verarbeitest.Box Eingabe als Zahl.
  • 🤖 KI-Unterstützung: GitHub Copilot und Visual Studio 2026 IntelliCode kann Ereignisbehandler generieren und eingegebene Daten validieren.

VB.NET-TextBox Steuerelementeigenschaften und Beispiele

Was ist Text?Box Steuerung?

Der TextBox Mit Control können Sie zur Laufzeit Text in Ihr Formular eingeben. Die Standardeinstellung ist, dass nur eine Textzeile akzeptiert wird. Sie können sie jedoch so ändern, dass mehrere Textzeilen akzeptiert werden. Sie können sogar Bildlaufleisten in Ihren Text einfügenBox Steuern.

TextBox Eigenschaften im Vergleich

Im Folgenden sind die häufigsten Eigenschaften des Visual Basic TextBox Steuerung:

  • Textausrichtung– zum Einstellen der Textausrichtung
  • Bildlaufleisten– zum Hinzufügen von Bildlaufleisten, sowohl vertikal als auch horizontal
  • Multiline– um den Text einzustellenBox Steuerung, um mehrere Zeilen zuzulassen
  • MaxLength– zur Angabe der maximalen Zeichenzahl des TextesBox Die Steuerung akzeptiert
  • Index– zur Angabe des Index des Steuerarrays
  • Nutzer der Smart‑Spaces‑App mit Google Wallet erhalten berührungslosen Mobile‑Zutritt an jedem NFC‑fähigen HID® Signo™‑Leser.– zum Aktivieren des Textbox-Steuerelements
  • Schreibgeschützt– Wenn der Wert auf „true“ gesetzt ist, können Sie den Text verwendenBox Wenn die Steuerung auf „false“ gesetzt ist, können Sie die Textfunktion nicht verwenden.Box Steuern.
  • AuswahlStart– zum Festlegen oder Abrufen des Ausgangspunkts für den TextBox Steuern.
  • Auswahllänge– zum Festlegen oder Abrufen der Anzahl der im Text ausgewählten ZeichenBox Steuern.
  • Ausgewählter Text– gibt den Text zurückBox Steuerelement, das derzeit ausgewählt ist.

TextBox VERANSTALTUNGEN

Der Zweck von Veranstaltungen besteht darin, den Text zu erstellenBox Die Steuerung reagiert auf Benutzeraktionen wie Klicks, Doppelklicks oder Änderungen der Textausrichtung. Hier sind die häufigsten Ereignisse für den TextBox Steuern:

  • AutoSizeChanged– Ausgelöst durch eine Änderung der AutoSize-Eigenschaft.
  • ReadOnlyChanged– Ausgelöst durch eine Änderung des ReadOnly-Eigenschaftswerts.
  • Klicken Sie auf – Ausgelöst durch einen Klick auf den TextBox Steuern.

So erstellen Sie einen TextBox

Folgen Sie diesen Schritten, um Ihren ersten Text hinzuzufügenBox Kontrolle zu einem Windows Eine Begrüßungsnachricht zur Laufzeit erstellen und anzeigen.

Schritt 1) ​​So erstellen Sie einen TextBox, ziehen Sie den TextBox Steuerung aus der Werkzeugkiste in die Windows Bilden:

TextBox Kontrolle hinzugefügt Windows Formgestaltungsoberfläche

Schritt 2)

  1. Klicken Sie auf den TextBox Steuerelement, das Sie dem Formular hinzugefügt haben.
  2. Gehen Sie zum Abschnitt Eigenschaften unten links auf dem Bildschirm. Ändern Sie den Namen des Textfelds von TextBox1 zu HelloTextBox:

Umbenennen des TextesBox an HelloTextBox im Eigenschaftenfenster

Schritt 3) Fügen Sie den folgenden Code hinzu, um dem Steuerelement Text hinzuzufügen:

Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
        'Add text to the control
         HelloTextBox.Text = "Hello. Welcome to Guru99!"
  End Sub

Schritt 4) Sie können den Code nun ausführen, indem Sie auf die Schaltfläche „Start“ in der oberen Leiste klicken:

Die Schaltfläche „Start“ in der Visual Studio-Symbolleiste wird verwendet, um das Projekt auszuführen.

Schritt 5) Sie sollten folgendes Formular erhalten:

Das Formular mit der Meldung "Hallo. Willkommen bei" wird ausgeführt. Guru99! im TextBox

Hier ist ein Screenshot des vollständigen Codes für das oben Gesagte:

Vervollständigen Sie den Form1_Load-Code, der HelloText festlegt.Box Text

Erklärung des Codes:

  1. Es wird eine öffentliche Klasse namens Form1 erstellt.
  2. Erstellen einer Unterprozedur mit dem Namen Form1_Load. Es wird aufgerufen, wenn das Formular geladen wird.
  3. Ein Kommentar. Der VB.NET-Compiler wird dies überspringen.
  4. Beenden Sie den Untervorgang.
  5. Beenden Sie den Unterricht.

PasswordChar-Eigenschaft

Manchmal möchte man, dass ein Textfeld für ... verwendet wird.ping Ein Passwort. Das bedeutet, dass alles, was in dieses Textfeld eingegeben wird, vertraulich bleiben muss. Dies ist möglich mit VB.Net. Dies kann mit der erfolgen Passwortchar Eigenschaft, die es uns ermöglicht, jedes gewünschte Zeichen zu verwenden. Lassen Sie uns dies anhand eines Beispiels demonstrieren:

Beginnen Sie mit der Erstellung eines neuen Projekts. Ziehen Sie zwei TextBox Steuerelemente, zwei Beschriftungen und eine Schaltfläche in das Formular. Ändern Sie die Texte auf den beiden Beschriftungen und der Schaltfläche wie folgt:

Anmeldeformular mit Benutzername-, Passwort- und TextfeldernBox Steuerelemente und Anmeldeschaltfläche

Klicken Sie auf das Textfeld neben der Bezeichnung „Benutzername“ und wechseln Sie zum Abschnitt „Eigenschaften“ unten links im Fenster. Geben Sie ihm den Namen „UsernameField“.

Festlegen der Namenseigenschaft des BenutzernamenstextesBox zum Benutzernamenfeld

Machen Sie dasselbe für den TextBox Klicken Sie auf die Schaltfläche „Passwort“ und geben Sie ihm den Namen „PasswortFeld“.

Festlegen der Namenseigenschaft des PassworttextesBox zum Passwortfeld

Sie sollten jetzt den PasswordField-Text erstellenBox Das Steuerelement zeigt für jedes eingegebene Zeichen ein * an. Fügen Sie den folgenden Code hinzu:

Private Sub PasswordField_TextChanged(sender As Object, e As EventArgs) Handles PasswordField.TextChanged
       PasswordField.PasswordChar = "*"
End Sub

Führen Sie nun den Code aus, indem Sie auf die Schaltfläche „Start“ klicken. Es öffnet sich ein Formular.

Geben Sie den Benutzernamen und das Passwort ein und beobachten Sie, was passiert. Sie sollten Folgendes sehen:

Anmeldeformular, bei dem das Passwortfeld mit Sternchen maskiert ist

Der Benutzername wird angezeigt, das Passwort wurde jedoch ausgeblendet. Hier ist der Code für das obige:

Vollständiger VB.NET-Code für den Ereignishandler PasswordChar für PasswordField_TextChanged

Erklärung des Codes:

  1. Erstellen einer Klasse mit dem Namen Form1.
  2. Es wird eine Unterprozedur namens PasswordField_TextChanged() erstellt. Sie wird beim Laden des Formulars aufgerufen.
  3. Verwenden der PasswordChar-Eigenschaft, um * anzuzeigen, während ein Benutzer das Passwort eingibt.
  4. Beenden des Untervorgangs.
  5. Den Unterricht beenden.

Zeilenumbruch im TextBox

Standardmäßig können Sie in einem Textfeld nur eine Textzeile erstellen. Es gibt zwei Möglichkeiten, wie wir dies erreichen können. Lassen Sie uns sie besprechen.

Ziehen Sie einen Text per Drag & DropBox Fügen Sie Ihrem Formular ein Steuerelement hinzu. Geben Sie dem Steuerelement den Namen. GuruHerzlich willkommen.

TextBox umbenannt in GuruWillkommensgruß auf der Formularoberfläche

Klicken Sie erneut auf das Textfeld-Steuerelement und bewegen Sie den Mauszeiger zum Abschnitt „Eigenschaften“. Ändern Sie den Wert der Eigenschaft „Mehrzeilig“ in „True“.

Die Eigenschaft „Mehrzeilig“ ist im Eigenschaftenfenster auf „Wahr“ gesetzt.

Alternativ können Sie die Multiline-Eigenschaft in Ihrem Code wie folgt auf „true“ setzen:

GuruWillkommen.Mehrzeilig = Wahr

Fügen Sie den folgenden Code hinzu:

 Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load

        GuruWelcome.Multiline = True

        GuruWelcome.Text = "Line 1"

        GuruWelcome.Text = GuruWelcome.Text & ControlChars.NewLine & "Line 2"

    End Sub

Bei der Ausführung werden die beiden Textzeilen getrennt.

Laufendes Formular, das Zeile 1 und Zeile 2 durch einen Zeilenumbruch getrennt anzeigt.

Erklärung von Code:

  1. Erstellen einer Klasse mit dem Namen Form1.
  2. Eine Unterroutine namens Form1_Load() wird erstellt.
  3. Wenn die Eigenschaft „Mehrzeilig“ auf „Wahr“ gesetzt wird, kann das Textfeld mehr als eine Zeile aufnehmen.
  4. Hinzufügen der ersten Textzeile zum Textfeld.
  5. Die zweite Textzeile wird in das Textfeld eingefügt. Die Eigenschaft ControlChars.NewLine hilft uns dabei, die beiden Zeilen zu trennen.
  6. Beenden der Unterroutine.
  7. Den Unterricht beenden.

Ganzzahlige Werte abrufen

VB.NET behandelt alles als Zeichenkette. Das bedeutet, dass Sie eine Ganzzahl aus dem Textfeld zunächst als Zeichenkette einlesen und sie dann in eine Ganzzahl umwandeln. Dies geschieht üblicherweise mit der Methode `Integer.Parse()`.

Um dies zu demonstrieren, erstellen Sie ein neues Textfeld-Steuerelement und eine Schaltfläche. Geben Sie dem Textfeld den Namen „age“. Geben Sie der Schaltfläche den Namen „Button1“. Sie sollten die folgende Schnittstelle haben:

TextBox Das angegebene Alter und eine Schaltfläche „Alter anzeigen“ sind auf dem Formular platziert.

Fügen Sie den folgenden Code hinzu:

Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
        Dim x As Integer
        x = Integer.Parse(age.Text)
        MessageBox.Show(x)

Führen Sie den Code aus und geben Sie Ihr Alter in das Textfeld ein. Klicken Sie auf die Schaltfläche Alter anzeigen. Sie sollten Folgendes sehen:

Dialogfeld „Alter anzeigen“, das den eingegebenen ganzzahligen Wert in einer Meldung anzeigt.Box

Der von Ihnen eingegebene Wert wird in einer Nachricht zurückgegebenBox.

Vollständiger Button1_Click-Code, der den Alterstext analysiertBox Wert in eine Ganzzahl umwandeln

Erklärung von Code:

  1. Erstellen einer Klasse mit dem Namen Form1.
  2. Erstellen einer Unterprozedur mit dem Namen Button1_Click. Es wird aufgerufen, wenn auf die Schaltfläche geklickt wird.
  3. Definieren einer Ganzzahlvariablen mit dem Namen x.
  4. Konvertieren des aus dem Textfeld „Alter“ gelesenen Werts in eine Ganzzahl.
  5. Anzeige des im obigen Schritt umgewandelten Werts in einer NachrichtBox.
  6. Beenden des Untervorgangs.

Schreibgeschützter TextBox

Sie können ein Textfeld schreibgeschützt machen. Das bedeutet, dass der Benutzer den im Textfeld angezeigten Wert nicht ändern kann. Dazu setzen Sie die Eigenschaft „ReadOnly“ auf „True“. Um dies zu demonstrieren, erstellen Sie ein neues Textfeld und geben Sie ihm den Namen „guru99“. Fügen Sie folgenden Code hinzu:

Private Sub guru99_TextChanged(sender As Object, e As EventArgs) Handles guru99.TextChanged

        guru99.Text = "welcome to Guru99"

        guru99.ReadOnly = True

    End Sub

Der Code sollte Folgendes zurückgeben:

Schreibgeschützter TextBox mit dem Text "Willkommen" Guru99, die nicht bearbeitet werden können

Hier ist der Code:

Vollständiger Code des Ereignishandlers guru99_TextChanged, der ReadOnly auf True setzt.

Erklärung von Code:

  1. Erstellen einer Klasse mit dem Namen Form1.
  2. Erstellen einer Unterroutine mit dem Namen guru99_TextChanged.
  3. Hinzufügen von Text zum Textfeld mit dem Namen „guru99“.
  4. Die ReadOnly-Eigenschaft des Textfelds wird auf „True“ gesetzt. Dadurch kann der Text im Textfeld nicht mehr geändert werden.
  5. Beenden des Untervorgangs.
  6. Den Unterricht beenden.

MaxLength-Eigenschaft

Mithilfe der Eigenschaft MaxLength können Sie die maximale Anzahl von Wörtern oder Zeichen festlegen, die das Textfeld zulässt. Um dies zu demonstrieren, erstellen Sie ein TextBox Geben Sie der Steuerung den Namen „fullName“. Fügen Sie folgenden Code hinzu:

Private Sub fullName_TextChanged(sender As Object, e As EventArgs) Handles fullName.TextChanged

        fullName.MaxLength = 8

    End Sub

Führen Sie den Code aus und versuchen Sie, Ihren vollständigen Namen einzugeben. Sie können nicht mehr als 8 Zeichen einschließlich Leerzeichen eingeben:

Maximale TextlängeBox Beschränkung der Eingabe auf acht Zeichen zur Laufzeit

Der Code:

Der vollständige Code von fullName_TextChanged, der MaxLength auf 8 setzt.

Code Erläuterung:

  1. Erstellen einer Klasse mit dem Namen Form1.
  2. Erstellen einer Unterprozedur mit dem Namen fullName_TextChanged.
  3. Das Textfeld „fullName“ akzeptiert maximal 8 Zeichen.
  4. Beenden des Untervorgangs.
  5. Den Unterricht beenden.

Häufig gestellte Fragen

A TextBox Speichert Klartext mit einer Zeichenbegrenzung von 64 KB und geringem Ressourcenverbrauch, ideal für Formulareingaben. RichTextBox Unterstützt Schriftarten, Farben, Bilder und unbegrenzte Länge und eignet sich daher für Redakteure, die formatierte oder längere Inhalte benötigen.

Behandeln Sie das KeyPress-Ereignis und setzen Sie es e.Handled = True sobald Char.IsDigit und Char.IsControl Beide geben False zurück. Verwenden Sie für eine kopiersichere Validierung das Validating-Ereignis mit Integer.TryParse und Feedback über einen ErrorProvider anzeigen.

Ja. GitHub-Copilot Liest den umgebenden Formularcode und schlägt vollständige TextChanged-, KeyPress- oder Validierungshandler vor. RevPrüfen Sie den generierten Code, fügen Sie Nullprüfungen hinzu und passen Sie die Namen vor der Annahme so an, dass er den Konventionen Ihres Projekts entspricht.

Visual Studio 2026 IntelliCode ordnet das wahrscheinlich nächste Mitglied auf Text einBox Instanzen, automatische Vervollständigung von Eigenschaftszuweisungen wie Multiline oder MaxLength und Vorschläge für die Bearbeitung ganzer Zeilen basierend auf Mustern, die aus Tausenden von Instanzen gelernt wurden Windows Formularprojekte.

Der Standardwert für MaxLength beträgt 32,767 Zeichen und entspricht damit dem Grenzwert von Int16.MaxValue. Setzen Sie den Wert auf eine kleinere positive Zahl, um die Eingabe zu begrenzen, oder auf 0, um die vom Steuerelement maximal unterstützte Zeichenanzahl zuzulassen.

Setzen Sie „Mehrzeilig“ auf „Wahr“ und „Zeilenumbruch“ auf „Wahr“. Der Zeilenumbruch ist standardmäßig aktiviert, sobald „Mehrzeilig“ eingeschaltet ist, sodass lange Zeilen an Wortgrenzen umgebrochen werden, anstatt horizontal zu scrollen. Fügen Sie „Scrollleisten = Vertikal“ hinzu, wenn der Text über den sichtbaren Bereich hinauswachsen kann.

Das Ereignis „TextChanged“ wird ausgelöst, sobald sich die Eigenschaft „Text“ aus irgendeinem Grund ändert, beispielsweise durch Einfügen oder programmatische Aktualisierungen. Das Ereignis „KeyPress“ wird einmal für jede gedrückte Zeichentaste ausgelöst.ping, bevor die Änderung den Puffer erreicht, weshalb es dazu dient, ungültige Zeichen zu blockieren.

Ein StandardtextBox Wendet eine Schriftart und Vordergrundfarbe auf das gesamte Steuerelement an. Bei farbigen Fragmenten, gemischten Schriftarten oder eingebetteten Bildern ersetzen Sie diese durch eine andere Schriftart und Vordergrundfarbe. RichTextBox, wodurch SelectionColor und SelectionFont für den aktuell ausgewählten Bereich angezeigt werden.

Fassen Sie diesen Beitrag mit folgenden Worten zusammen: