Tutoriel de contrôle VB.Net TEXTBOX : propriétés avec exemple

⚡ Résumé intelligent

TexteBox Les contrôles en VB.Net acceptent les entrées utilisateur sur un Windows Créez et exposez des propriétés telles que Multiline, PasswordChar, MaxLength et ReadOnly pour définir la manière dont le texte est saisi, masqué, limité ou verrouillé lors de l'exécution.

  • 🧩 Objectif principal : Le texteBox Le système de contrôle capture les entrées utilisateur sur une ou plusieurs lignes. Windows Formez-vous pendant l'exécution.
  • 🔤 Propriétés clés : Les propriétés TextAlign, ScrollBars, Multiline, MaxLength, Readonly et PasswordChar permettent de personnaliser le comportement des contrôles.
  • (I.e. Masquage du mot de passe : Définir PasswordChar sur * masque les caractères pendant que l'utilisateur tape, gardeping Les données sensibles sont privées.
  • 📄 Plusieurs lignes : Activez l'option Multiline, puis utilisez ControlChars.NewLine pour répartir le texte sur plusieurs lignes.
  • (I.e. Valeurs numériques : Convertissez la chaîne avec Integer.Parse avant de traiter tout texte.Box entrée sous forme de nombre.
  • 🤖 Assistance IA : GitHub Copilot et Visual Studio 2026 IntelliCode peut générer des gestionnaires d'événements et valider les entrées typées.

Texte VB.NetBox Propriétés et exemples de contrôle

Qu'est-ce que le texteBox Contrôler?

Le texteBox Control vous permet de saisir du texte sur votre formulaire pendant l'exécution. Le paramètre par défaut est qu'il n'acceptera qu'une seule ligne de texte, mais vous pouvez le modifier pour accepter plusieurs lignes. Vous pouvez même inclure des barres de défilement dans votre texteBox Contrôle.

TexteBox Propriétés

Voici les propriétés les plus courantes du texte Visual BasicBox commande:

  • TextAlign– pour définir l’alignement du texte
  • ScrollBars– pour ajouter des barres de défilement, verticales et horizontales
  • Multiline– pour définir le texteBox Contrôle pour autoriser plusieurs lignes
  • Longueur maximale– pour spécifier le nombre maximum de caractères du texteBox Le contrôle acceptera
  • Sommaire- pour spécifier l'index du tableau de contrôle
  • Les utilisateurs de l’app Smart Spaces avec Google Wallet profitent d’un accès mobile sans contact avec tout lecteur HID® Signo™ compatible NFC.– pour activer le contrôle de zone de texte
  • Lecture seulement– s’il est défini sur true, vous pourrez utiliser le texteBox Si la valeur de Contrôle est définie sur faux, vous ne pourrez pas utiliser le texte.Box Contrôle.
  • SélectionDébut– pour définir ou obtenir le point de départ du texteBox Contrôle.
  • Longueur de la sélection– pour définir ou obtenir le nombre de caractères sélectionnés dans le texteBox Contrôle.
  • TexteSélectionné– renvoie le texteBox Contrôle actuellement sélectionné.

TexteBox Événements

Le but des événements est de rendre le TexteBox Le contrôle répond aux actions de l'utilisateur telles qu'un clic, un double-clic ou une modification de l'alignement du texte. Voici les événements communs pour le TexteBox Contrôle:

  • TailleAutoModifiée– Déclenché par une modification de la propriété AutoSize.
  • Lecture seuleModifié– Déclenché par une modification de la valeur de la propriété ReadOnly.
  • Cliquez à nouveau– Déclenché par un clic sur le TexteBox Contrôle.

Comment créer un texteBox

Suivez ces étapes pour ajouter votre premier texteBox contrôle à un Windows Générez et affichez un message de bienvenue lors de l'exécution.

Étape 1) Créer un texteBox, faites glisser le texteBox contrôle de la boîte à outils dans le Windows Forme:

TexteBox contrôle ajouté au Windows Surface de conception de forme

Étape 2)

  1. Cliquez sur le texteBox Contrôlez que vous avez ajouté au formulaire.
  2. Accédez à la section Propriétés située en bas à gauche de l'écran. Modifiez le nom de la zone de texte de TexteBox1 à BonjourTexteBox:

Renommer le texteBox à HelloTextBox dans la fenêtre Propriétés

Étape 3) Ajoutez le code suivant pour ajouter du texte au contrôle :

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

Étape 4) Vous pouvez maintenant exécuter le code en cliquant sur le bouton Démarrer situé dans la barre supérieure :

Le bouton Démarrer de la barre d'outils de Visual Studio permet d'exécuter le projet.

Étape 5) Vous devriez obtenir le formulaire suivant :

Exécution du formulaire affichant Bonjour. Bienvenue sur Guru99 ! dans le texteBox

Voici une capture d'écran du code complet de ce qui précède :

Code complet de Form1_Load qui définit HelloTextBox texte

Explication du code:

  1. Création d'une classe publique nommée Form1.
  2. Création d'une sous-procédure nommée Form1_Load. Il sera appelé lorsque le formulaire sera chargé.
  3. Un commentaire. Le compilateur VB.Net ignorera ce commentaire.
  4. Terminez la sous-procédure.
  5. Terminez le cours.

Propriété PasswordChar

Parfois, vous souhaitez utiliser une zone de texte pour saisir du texte.ping un mot de passe. Cela signifie que tout ce qui est saisi dans cette zone de texte doit rester confidentiel. C'est possible avec VB.Net. Cela peut être fait en utilisant le Passwordchar propriété qui nous permet d'utiliser n'importe quel caractère que vous souhaitez. Montrons cela à l'aide d'un exemple :

Commencez par créer un nouveau projet. Faites glisser deux textesBox Contrôles, deux étiquettes et un bouton dans le formulaire. Modifiez les textes des deux étiquettes et du bouton comme suit :

Conception d'un formulaire de connexion avec nom d'utilisateur, mot de passe et texteBox commandes et bouton de connexion

Cliquez sur la zone de texte à côté de l'étiquette Nom d'utilisateur, accédez à la section Propriétés située en bas à gauche de la fenêtre. Donnez-lui le nom UsernameField.

Définition de la propriété Nom du texte du nom d'utilisateurBox champ Nom d'utilisateur

Faites de même pour le texteBox Contrôlez à côté de l'étiquette du mot de passe, en lui donnant le nom PasswordField.

Définition de la propriété Nom du texte du mot de passeBox champ de mot de passe

Vous devriez maintenant créer le texte PasswordFieldBox La commande affiche * pour chaque caractère saisi. Ajoutez le code suivant :

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

Maintenant, exécutez le code en cliquant sur le bouton Démarrer. Un formulaire apparaîtra.

Tapez le nom d'utilisateur et le mot de passe et observez ce qui se passe. Vous devriez voir ce qui suit :

Formulaire de connexion fonctionnant avec le champ mot de passe masqué par des astérisques

Le nom d'utilisateur est affiché, mais le mot de passe a été masqué. Voici le code pour ce qui précède :

Code complet du gestionnaire d'événements PasswordChar en VB.Net pour PasswordField_TextChanged

Explication du code:

  1. Création d'une classe nommée Form1.
  2. Création d'une sous-procédure nommée PasswordField_TextChanged(). Elle sera appelée lors du chargement du formulaire.
  3. Utilisation de la propriété PasswordChar pour afficher * lorsqu'un utilisateur saisit le mot de passe.
  4. Fin de la sous-procédure.
  5. Fin du cours.

Nouvelle ligne dans le texteBox

Par défaut, vous ne pouvez créer qu'une seule ligne de texte dans une zone de texte. Nous pouvons y parvenir de deux manières. Discutons-en.

Glissez et déposez un texteBox Ajoutez un contrôle à votre formulaire. Nommez ce contrôle. GuruBienvenue.

TexteBox renommé en GuruBienvenue affiché sur la surface du formulaire

Cliquez à nouveau sur le contrôle de zone de texte et déplacez le curseur de la souris vers la section Propriétés. Modifiez la valeur de la propriété Multiline sur True.

L'option « Multiligne » est activée dans la fenêtre Propriétés.

Vous pouvez également définir la propriété Multiline sur true dans votre code comme suit :

GuruBienvenue.Multiligne = Vrai

Ajoutez le code suivant :

 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

Lors de l'exécution, les deux lignes de texte seront séparées.

Formulaire courant montrant la ligne 1 et la ligne 2 séparées par un saut de ligne

Explication de Code:

  1. Création d'une classe nommée Form1.
  2. Création d'une sous-routine nommée Form1_Load().
  3. Définissez la propriété Multiligne sur Vrai. La zone de texte pourra alors contenir plusieurs lignes.
  4. Ajout de la première ligne de texte à la zone de texte.
  5. Ajout d'une deuxième ligne de texte à la zone de texte. La propriété ControlChars.NewLine nous permet de séparer les deux lignes.
  6. Fin du sous-programme.
  7. Fin du cours.

Récupération de valeurs entières

En VB.Net, tout est traité comme une chaîne de caractères. Cela signifie que vous lisez un entier depuis la zone de texte comme une chaîne, puis vous le convertissez en entier. Cette opération est généralement réalisée à l'aide de la méthode Integer.Parse().

Pour démontrer cela, créez un nouveau contrôle de zone de texte plus un bouton. Donnez à la zone de texte le nom age. Donnez au bouton le nom Button1. Vous devriez avoir l'interface suivante :

TexteBox L'âge indiqué et un bouton « Afficher l'âge » ont été placés sur le formulaire.

Ajoutez le code suivant :

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)

Exécutez le code et entrez votre âge dans la zone de texte. Cliquez sur le bouton Afficher l'âge. Vous devriez voir ce qui suit :

Afficher la boîte de dialogue Âge affichant la valeur entière saisie dans un messageBox

La valeur que vous entrez est renvoyée dans un messageBox.

Code complet du bouton 1_Click qui analyse le texte de l'âgeBox valeur vers un entier

Explication de Code:

  1. Création d'une classe nommée Form1.
  2. Création d'une sous-procédure nommée Button1_Click. Il sera appelé lorsque le bouton sera cliqué.
  3. Définir une variable entière nommée x.
  4. Conversion de la valeur lue dans la zone de texte nommée age en un entier.
  5. Affichage de la valeur convertie à l'étape ci-dessus dans un messageBox.
  6. Fin de la sous-procédure.

Texte en lecture seuleBox

Vous pouvez rendre une zone de texte en lecture seule. Cela signifie que l'utilisateur ne pourra pas modifier la valeur affichée dans la zone de texte. Pour ce faire, définissez la propriété ReadOnly sur True. Pour illustrer cela, créez une nouvelle zone de texte et nommez-la guru99. Ajoutez le code suivant :

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

        guru99.Text = "welcome to Guru99"

        guru99.ReadOnly = True

    End Sub

Le code doit renvoyer ce qui suit :

Texte en lecture seuleBox Courir avec du texte bienvenue à Guru99 qui ne peuvent pas être modifiés

Voici le code:

Code complet du gestionnaire d'événements guru99_TextChanged, paramètre ReadOnly défini sur True

Explication de Code:

  1. Création d'une classe nommée Form1.
  2. Création d'un sous-programme nommé guru99_TextChanged.
  3. Ajout de texte à la zone de texte nommée guru99.
  4. Définissez la propriété ReadOnly de la zone de texte sur True. Cela rend le texte de la zone de texte non modifiable.
  5. Fin de la sous-procédure.
  6. Fin du cours.

Propriété MaxLength

La propriété MaxLength peut vous aider à définir le nombre maximal de mots ou de caractères que la zone de texte autorisera. Pour illustrer cela, créez un texteBox Créez un contrôle et nommez-le fullName. Ajoutez le code suivant :

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

        fullName.MaxLength = 8

    End Sub

Exécutez le code et essayez de taper votre nom complet. Vous ne pourrez pas saisir plus de 8 caractères, espaces compris :

Texte de longueur maximaleBox limiter la saisie à huit caractères lors de l'exécution

Le code:

Code complet de fullName_TextChanged qui définit MaxLength à 8

Code Explication:

  1. Création d'une classe nommée Form1.
  2. Création d'une sous-procédure nommée fullName_TextChanged.
  3. Faire en sorte que la zone de texte fullName accepte un maximum de seulement 8 caractères.
  4. Fin de la sous-procédure.
  5. Fin du cours.

FAQ

A TexteBox Enregistre du texte brut avec une limite de 64 Ko et une faible consommation de ressources, idéal pour la saisie de formulaires. Texte richeBox Il prend en charge les polices, les couleurs, les images et une longueur illimitée, ce qui le rend idéal pour les rédacteurs ayant besoin de contenu stylisé ou long.

Gérer l'événement KeyPress et définir e.Handled = True chaque fois que Char.IsDigit et Char.IsControl Les deux renvoient False. Pour une validation sécurisée du collage, utilisez l'événement Validating avec Integer.TryParse et afficher les commentaires via un ErrorProvider.

Oui. Copilote GitHub lit le code du formulaire environnant et suggère des gestionnaires TextChanged, KeyPress ou Validating complets. RevExaminez le code généré, ajoutez des vérifications de valeurs nulles et ajustez les noms avant de l'accepter afin qu'il corresponde aux conventions de votre projet.

Visual Studio 2026 IntelliCode classe le prochain membre probable sur TextBox par exemple, il complète automatiquement les affectations de propriétés comme Multiline ou MaxLength et suggère des modifications de lignes entières en fonction de modèles appris à partir de milliers de Windows Projets de formulaires.

La valeur par défaut de MaxLength est de 32 767 caractères, ce qui correspond à la limite de Int16.MaxValue. Définissez cette propriété sur un nombre positif inférieur pour limiter la saisie, ou sur 0 pour autoriser la valeur maximale prise en charge par le contrôle.

Activez le mode Multiligne et le retour à la ligne automatique. Le retour à la ligne automatique est activé par défaut dès que le mode Multiligne est activé ; ainsi, les lignes longues sont coupées à la fin de chaque mot au lieu de défiler horizontalement. Ajoutez l’option Barres de défilement verticales si le texte peut dépasser la zone visible.

L'événement TextChanged est déclenché après toute modification de la propriété Text, quelle qu'en soit la raison, y compris le collage ou les mises à jour programmatiques. L'événement KeyPress est déclenché une fois pour chaque touche de caractère saisie.ping, avant que la modification n'atteigne le tampon, c'est pourquoi il est utilisé pour bloquer les caractères invalides.

Un texte standardBox Applique une police et une couleur de premier plan à l'ensemble du contrôle. Pour les fragments colorés, les polices mixtes ou les images incorporées, remplacez-le par un Texte richeBox, qui expose SelectionColor et SelectionFont sur la plage actuellement sélectionnée.

Résumez cet article avec :