Samouczek dotyczący kontrolki TEXTBOX w języku VB.Net: Właściwości z przykładem

⚡ Inteligentne podsumowanie

TekstBox Kontrolki w VB.Net akceptują dane wprowadzane przez użytkownika Windows Właściwości formularza i jego udostępniania, takie jak Multiline, PasswordChar, MaxLength i ReadOnly, umożliwiają określenie sposobu wprowadzania, ukrywania, ograniczania lub blokowania tekstu w czasie wykonywania.

  • 🧩 Główny cel: TekstBox Sterowanie przechwytuje dane wejściowe użytkownika w jednym wierszu lub w wielu wierszach. Windows Formularz w czasie wykonywania.
  • 🔤 Kluczowe właściwości: Funkcje TextAlign, ScrollBars, Multiline, MaxLength, Readonly i PasswordChar dostosowują zachowanie kontrolki.
  • 🔐 Maskowanie hasła: Ustawienie parametru PasswordChar na * powoduje ukrycie znaków podczas wpisywania ich przez użytkownika,ping wrażliwe dane wejściowe prywatne.
  • 📄 Wiele linii: Ustaw Multiline na True, a następnie użyj ControlChars.NewLine, aby podzielić tekst na osobne wiersze.
  • 🔢 Wartości liczbowe: Konwertuj ciąg za pomocą Integer.Parse przed przetworzeniem tekstuBox wpis jako liczba.
  • 🤖 Pomoc AI: GitHub Copilot i Visual Studio 2026 IntelliCode może generować procedury obsługi zdarzeń i weryfikować wprowadzone dane.

Tekst VB.NetBox Właściwości sterujące i przykłady

Co to jest tekstBox Kontrola?

TekstBox Kontrola umożliwia wprowadzanie tekstu w formularzu w czasie jego wykonywania. Domyślnym ustawieniem jest akceptowanie tylko jednego wiersza tekstu, ale można je zmodyfikować, aby akceptowało wiele wierszy. Możesz nawet dołączyć paski przewijania do swojego tekstuBox Kontrola.

TekstBox Właściwości

Poniżej przedstawiono najczęstsze właściwości tekstu Visual BasicBox kontrola:

  • Wyrównanie tekstu– do ustawiania wyrównania tekstu
  • Paski przewijania– do dodawania pasków przewijania, zarówno w pionie, jak i w poziomie
  • Wielowierszowy– aby ustawić TekstBox Kontroluj, aby zezwolić na wiele linii
  • Maksymalna długość– do określenia maksymalnej liczby znaków TekstBox Kontrola zaakceptuje
  • wskaźnik– do określenia indeksu tablicy sterującej
  • Użytkownicy aplikacji Smart Spaces z Google Wallet mogą korzystać z bezdotykowego dostępu mobilnego z każdym czytnikiem HID® Signo™ z NFC.– w celu włączenia kontroli pola tekstowego
  • Tylko czytać– jeśli ustawione na true, będziesz mógł używać TextBox Jeśli ustawisz Kontrolę na fałsz, nie będziesz mógł używać TekstuBox Kontrola.
  • WybórRozpocznij– do ustawienia lub uzyskania punktu początkowego TekstuBox Kontrola.
  • Długość wyboru– do ustawienia lub uzyskania liczby znaków, które zostały wybrane w tekścieBox Kontrola.
  • Wybrany tekst– zwraca TekstBox Kontrolka, która jest aktualnie wybrana.

TekstBox Wydarzenia

Celem wydarzeń jest stworzenie TekstuBox Kontrolka reaguje na działania użytkownika, takie jak kliknięcie, podwójne kliknięcie lub zmiana wyrównania tekstu. Oto typowe zdarzenia dla TextBox Kontrola:

  • Zmieniono rozmiar automatyczny– Wywoływane przez zmianę właściwości AutoSize.
  • Tylko do odczytuZmieniono– Wywoływane przez zmianę wartości właściwości ReadOnly.
  • Kliknij– Wywoływane przez kliknięcie na TekstBox Kontrola.

Jak stworzyć tekstBox

Aby dodać pierwszy tekst, wykonaj poniższe krokiBox kontrola do Windows Utwórz i wyświetl komunikat powitalny w czasie wykonywania.

Krok 1) Aby utworzyć tekstBox, przeciągnij TekstBox sterowanie z skrzynki narzędziowej do Windows Forma:

TekstBox dodane sterowanie do Windows Powierzchnia projektu formularza

Krok 2)

  1. Kliknij TekstBox Kontrolka, którą dodałeś do formularza.
  2. Przejdź do sekcji Właściwości znajdującej się w lewym dolnym rogu ekranu. Zmień nazwę pola tekstowego z TekstBox1 do HelloTextBox:

Zmiana nazwy tekstuBox do HelloTextBox w oknie Właściwości

Krok 3) Dodaj następujący kod, aby dodać tekst do kontrolki:

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

Krok 4) Teraz możesz uruchomić kod, klikając przycisk Start znajdujący się na górnym pasku:

Przycisk Start na pasku narzędzi programu Visual Studio służący do uruchamiania projektu

Krok 5) Powinieneś otrzymać następujący formularz:

Uruchamiam formularz z napisem „Witaj”. Witamy w Guru99! w tekścieBox

Oto zrzut ekranu pełnego kodu powyższego:

Uzupełnij kod Form1_Load, który ustawia HelloTextBox XNUMX

Wyjaśnienie kodu:

  1. Tworzenie klasy publicznej o nazwie Form1.
  2. Tworzenie procedury podrzędnej o nazwie Form1_Load. Zostanie wywołana po załadowaniu formularza.
  3. Komentarz. Kompilator VB.Net pominie ten krok.
  4. Zakończ podprocedurę.
  5. Zakończ zajęcia.

Właściwość PasswordChar

Czasami chcesz użyć pola tekstowego doping hasło. Oznacza to, że wszystko, co zostanie wpisane w tym polu tekstowym, musi pozostać poufne. Jest to możliwe dzięki VB.Net. Można to zrobić za pomocą HasłoChar właściwość, która pozwala nam użyć dowolnego znaku, jaki chcesz. Zademonstrujmy to na przykładzie:

Rozpocznij od utworzenia nowego projektu. Przeciągnij dwa TekstyBox Kontrolki, dwie etykiety i jeden przycisk do formularza. Zmień teksty na dwóch etykietach i przycisku na następujące:

Projekt formularza logowania z etykietami nazwy użytkownika, hasła i tekstuBox elementy sterujące i przycisk Zaloguj

Kliknij pole tekstowe obok etykiety Username, przejdź do sekcji Properties znajdującej się w lewym dolnym rogu okna. Nadaj jej nazwę UsernameField.

Ustawianie właściwości Nazwa tekstu nazwy użytkownikaBox do pola nazwy użytkownika

Zrób to samo z tekstemBox Kontrolkę obok etykiety Hasło, nadając jej nazwę PasswordField.

Ustawianie właściwości Nazwa tekstu hasłaBox do pola hasła

Powinieneś teraz utworzyć tekst pola hasłaBox Kontrolka pokazuje * dla każdego wpisanego znaku. Dodaj następujący kod:

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

Teraz uruchom kod, klikając przycisk Start. Pojawi się formularz.

Wpisz nazwę użytkownika i hasło i obserwuj, co się stanie. Powinieneś zobaczyć następujące:

Formularz logowania działa z polem hasła zamaskowanym gwiazdkami

Wyświetlana jest nazwa użytkownika, ale hasło zostało ukryte. Oto kod powyższego:

Pełny kod obsługi zdarzeń VB.Net PasswordChar dla PasswordField_TextChanged

Wyjaśnienie kodu:

  1. Tworzenie klasy o nazwie Form1.
  2. Tworzę podprocedurę o nazwie PasswordField_TextChanged(). Zostanie ona wywołana po załadowaniu formularza.
  3. Użycie właściwości PasswordChar do wyświetlenia znaku *, gdy użytkownik wpisuje hasło.
  4. Zakończenie podprocedury.
  5. Zakończenie zajęć.

Nowa linia w tekścieBox

Domyślnie możesz utworzyć tylko jedną linię tekstu w polu tekstowym. Istnieją dwa sposoby, dzięki którym możemy to osiągnąć. Omówmy je.

Przeciągnij i upuść tekstBox Kontrolka do Twojego formularza. Nadaj kontrolce nazwę GuruWitamy.

TekstBox przemianowany na GuruPowitanie wyświetlane na powierzchni projektowej formularza

Kliknij ponownie kontrolkę pola tekstowego i przesuń kursor myszy do sekcji Właściwości. Zmień wartość właściwości Multiline na True.

Właściwość wielowierszowa ustawiona na Prawda w oknie Właściwości

Alternatywnie możesz ustawić właściwość Multiline na true w swoim kodzie w następujący sposób:

GuruWitamy.Multiline = Prawda

Dodaj następujący kod:

 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

Po wykonaniu dwa wiersze tekstu zostaną rozdzielone.

Formularz bieżący pokazujący wiersz 1 i wiersz 2 oddzielone nową linią

Wyjaśnienie Code:

  1. Tworzenie klasy o nazwie Form1.
  2. Tworzenie podprogramu o nazwie Form1_Load().
  3. Ustaw właściwość „Multiline” na „True”. Pole tekstowe będzie mogło pomieścić więcej niż jeden wiersz.
  4. Dodanie pierwszego wiersza tekstu do pola tekstowego.
  5. Dodanie drugiego wiersza tekstu do pola tekstowego. Właściwość ControlChars.NewLine pomaga nam rozdzielić dwa wiersze.
  6. Zakończenie podprogramu.
  7. Zakończenie zajęć.

Pobieranie wartości całkowitych

VB.Net traktuje wszystko jak ciąg znaków. Oznacza to, że odczytujesz liczbę całkowitą z pola tekstowego jako ciąg znaków, a następnie konwertujesz ją na liczbę całkowitą. Zazwyczaj odbywa się to za pomocą metody Integer.Parse().

Aby to zademonstrować, utwórz nowy element sterujący polem tekstowym i przycisk. Nadaj polu tekstowemu nazwę age. Nadaj przyciskowi nazwę Button1. Powinieneś mieć następujący interfejs:

TekstBox nazwany wiek i przycisk „Pokaż wiek” umieszczony na formularzu

Dodaj następujący kod:

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)

Uruchom kod i wpisz swój wiek w polu tekstowym. Kliknij przycisk Show Age. Powinieneś zobaczyć następujące informacje:

Pokaż okno dialogowe Wiek wyświetlające wprowadzoną wartość całkowitą w wiadomościBox

Wprowadzona wartość zostanie zwrócona w wiadomościBox.

Pełny kod Button1_Click analizujący tekst wiekuBox wartość do liczby całkowitej

Wyjaśnienie Code:

  1. Tworzenie klasy o nazwie Form1.
  2. Tworzenie podprocedury o nazwie Button1_Click. Zostanie wywołana po kliknięciu przycisku.
  3. Definiowanie zmiennej całkowitej o nazwie x.
  4. Konwersja wartości odczytanej z pola tekstowego o nazwie wiek na liczbę całkowitą.
  5. Wyświetlanie wartości przeliczonej w powyższym kroku w komunikacieBox.
  6. Zakończenie podprocedury.

Tekst tylko do odczytuBox

Możesz ustawić pole tekstowe jako tylko do odczytu. Oznacza to, że użytkownik nie będzie mógł modyfikować wartości wyświetlanej w polu tekstowym. Aby to zrobić, ustaw właściwość ReadOnly na True. Aby to zademonstrować, utwórz nowe pole tekstowe i nadaj mu nazwę guru99. Dodaj następujący kod:

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

        guru99.Text = "welcome to Guru99"

        guru99.ReadOnly = True

    End Sub

Kod powinien zwrócić następującą informację:

Tekst tylko do odczytuBox bieganie z tekstem witaj Guru99, których nie można edytować

Oto kod:

Pełny kod obsługi zdarzeń guru99_TextChanged ustawiający ReadOnly na True

Wyjaśnienie Code:

  1. Tworzenie klasy o nazwie Form1.
  2. Tworzenie podprogramu o nazwie guru99_TextChanged.
  3. Dodawanie tekstu do pola tekstowego o nazwie guru99.
  4. Ustawienie właściwości ReadOnly pola tekstowego na True (Prawda). Spowoduje to, że tekst w polu tekstowym będzie niemodyfikowalny.
  5. Zakończenie podprocedury.
  6. Zakończenie zajęć.

Właściwość MaxLength

Właściwość MaxLength może pomóc Ci ustawić maksymalną liczbę słów lub znaków, na które pozwoli pole tekstowe. Aby to zademonstrować, utwórz pole tekstoweBox Kontrolkę i nadaj jej nazwę fullName. Dodaj następujący kod:

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

        fullName.MaxLength = 8

    End Sub

Uruchom kod i spróbuj wpisać swoje imię i nazwisko. Nie będziesz mógł wpisać więcej niż 8 znaków, łącznie ze spacjami:

Maksymalna długość tekstuBox ograniczenie wprowadzania danych do ośmiu znaków w czasie wykonywania

Kod:

Pełny kod fullName_TextChanged, który ustawia MaxLength na 8

Code Wyjaśnienie:

  1. Tworzenie klasy o nazwie Form1.
  2. Tworzenie podprocedury o nazwie fullName_TextChanged.
  3. W polu tekstowym fullName wprowadzono możliwość wprowadzenia maksymalnie 8 znaków.
  4. Zakończenie podprocedury.
  5. Zakończenie zajęć.

FAQ

A TekstBox Przechowuje zwykły tekst z limitem 64 KB znaków i niskim zużyciem zasobów, idealny do wprowadzania danych do formularzy. Bogaty tekstBox obsługuje czcionki, kolory, obrazy i nieograniczoną długość, dlatego nadaje się dla redaktorów potrzebujących treści stylizowanych lub o dłuższej formie.

Obsłuż zdarzenie KeyPress i ustaw e.Handled = True ilekroć Char.IsDigit oraz Char.IsControl Obie zwracają False. Aby zapewnić walidację bezpieczną do wklejenia, użyj zdarzenia Validating z Liczba całkowita.TryParse i wyświetl informację zwrotną za pomocą ErrorProvider.

Tak. Drugi pilot GitHub odczytuje otaczający kod formularza i sugeruje pełne procedury obsługi TextChanged, KeyPress lub Validating. Revprzejrzyj wygenerowany kod, dodaj sprawdzenia wartości null i dostosuj nazwy przed zaakceptowaniem, tak aby odpowiadał konwencjom Twojego projektu.

Visual Studio 2026 IntelliCode klasyfikuje prawdopodobnego następnego członka w tekścieBox wystąpienia, automatycznie uzupełnia przypisania właściwości, takie jak Multiline lub MaxLength, i sugeruje edycje całych wierszy na podstawie wzorców poznanych z tysięcy Windows Projekty formularzy.

Domyślna wartość MaxLength wynosi 32 767 znaków, co odpowiada limitowi Int16.MaxValue. Ustaw właściwość na dowolną mniejszą liczbę dodatnią, aby ograniczyć dane wejściowe, lub ustaw ją na 0, aby zezwolić na maksymalną liczbę znaków obsługiwaną przez kontrolkę.

Ustaw opcję Multiline na True, a opcję WordWrap na True. Funkcja WordWrap jest domyślnie włączona po włączeniu opcji Multiline, więc długie wiersze są łamane na granicach wyrazów, zamiast przewijać je w poziomie. Dodaj opcję ScrollBars = Vertical, jeśli tekst może wychodzić poza widoczny obszar.

Zdarzenie TextChanged jest aktywowane po zmianie właściwości Tekst z dowolnego powodu, w tym wklejenia lub aktualizacji programowych. Zdarzenie KeyPress jest aktywowane raz dla każdego naciśnięcia znaku podczasping, zanim zmiana dotrze do bufora, dlatego też jest używana do blokowania nieprawidłowych znaków.

Standardowy tekstBox Stosuje jedną czcionkę i jeden kolor do całego elementu sterującego. W przypadku kolorowych fragmentów, czcionek mieszanych lub osadzonych obrazów, zamień je na Bogaty tekstBox, który udostępnia SelectionColor i SelectionFont w aktualnie wybranym zakresie.

Podsumuj ten post następująco: