Vue d'ensemble du contrôle serveur Web TextBox

Article
10/22/2014

Mise à jour : novembre 2007

Le contrôle serveur Web TextBox offre aux utilisateurs la possibilité d'entrer des informations dans une page Web ASP.NET, notamment du texte, des nombres et des dates.

Cette rubrique contient les sections suivantes :

Contexte
Exemples de code
Référence de Classe

Contexte

Le contrôle serveur TextBox est un contrôle d'entrée qui permet à l'utilisateur d'entrer du texte. Par défaut, la propriété TextMode du contrôle a la valeur TextBoxMode.SingleLine, qui s'affiche dans une zone de texte d'une seule ligne. Toutefois, vous pouvez définir la propriété TextMode à TextBoxMode.MultiLine pour afficher une zone de texte multiligne (restituée en tant qu'élément textarea). Vous pouvez également modifier la propriété TextMode en TextBoxMode.Password pour afficher une zone de texte qui masque l'entrée d'utilisateur. Le texte affiché dans le contrôle TextBox est disponible en utilisant la méthode Text.

Note de sécurité :
La définition de la propriété TextMode à TextBoxMode.Password peut aider à s'assurer que personne d'autre ne peut observer le mot de passe pendant sa saisie. Toutefois, le texte tapé dans la zone de texte n'est pas chiffré et doit être protégé comme toute autre donnée confidentielle. Par exemple, pour une sécurité accrue lors de la publication d'une page contenant un mot de passe, vous pouvez utiliser le protocole SSL (Secure Sockets Layer) et le chiffrement.

La définition de la propriété TextMode à TextBoxMode.Password peut aider à s'assurer que personne d'autre ne peut observer le mot de passe pendant sa saisie. Toutefois, le texte tapé dans la zone de texte n'est pas chiffré et doit être protégé comme toute autre donnée confidentielle. Par exemple, pour une sécurité accrue lors de la publication d'une page contenant un mot de passe, vous pouvez utiliser le protocole SSL (Secure Sockets Layer) et le chiffrement.

Note de sécurité :
Les entrées d'utilisateur dans une page Web ASP.NET peuvent inclure un script client nuisible. Par défaut, la page Web ASP.NET vérifie que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script.

Événements du contrôle TextBox

Le contrôle TextBox déclenche un événement TextChanged lorsque l'utilisateur quitte le contrôle. Par défaut, l'événement n'est pas déclenché immédiatement ; en fait, il est déclenché sur le serveur lorsque la page est soumise. Toutefois, vous pouvez configurer le contrôle TextBox afin qu'il soumette la page au serveur dès que l'utilisateur sort du champ.

Le contrôle serveur Web TextBox ne déclenche pas d'événement chaque fois que l'utilisateur appuie sur une séquence de touches, mais uniquement lorsqu'il quitte le contrôle. Vous pouvez configurer le contrôle TextBox pour qu'il déclenche des événements côté client que vous gérez dans le script client, ce qui peut s'avérer utile pour répondre à des séquences de touches individuelles. Pour plus d'informations, consultez Script client dans les pages Web ASP.NET.

Légendes TextBox

Vous pouvez utiliser les contrôles Label pour créer des légendes pour les contrôles TextBox. La légende peut définir une touche d'accès rapide sur laquelle les utilisateurs peuvent appuyer pour naviguer jusqu'au contrôle TextBox. Pour plus d'informations, consultez Comment : utiliser des contrôles serveur Web Label en tant que légendes.

Saisie semi-automatique dans les zones de texte

De nombreux navigateurs prennent en charge une fonctionnalité de saisie semi-automatique qui aide les utilisateurs à remplir des zones de texte en fonction des valeurs qu'ils ont entrées précédemment. Le comportement exact de saisie semi-automatique dépend du navigateur. En général, les navigateurs enregistrent les valeurs sur la base de l'attribut name de la zone de texte ; toute zone de texte portant le même nom, même sur une page différente, proposera les mêmes valeurs à l'utilisateur. Certains navigateurs prennent également en charge un schéma vCard qui permet aux utilisateurs de créer un profil dans le navigateur avec des valeurs prédéfinies pour le prénom, le nom, le numéro de téléphone, l'adresse de messagerie, et ainsi de suite.

Le contrôle TextBox prend en charge une propriété AutoCompleteType qui fournit les options suivantes permettant de contrôler le fonctionnement du navigateur avec la saisie semi-automatique :

Désactiver la saisie semi-automatique. Si vous ne souhaitez pas que le navigateur propose la saisie semi-automatique pour une zone de texte, vous pouvez désactiver cette option.
Spécifiez une valeur vCard à utiliser comme valeur de saisie semi-automatique pour le champ. Le navigateur doit prendre en charge le schéma vCard.