Comment : spécifier une entrée multiligne pour un contrôle serveur Web TextBox
Mise à jour : novembre 2007
Un contrôle TextBox multiligne permet aux utilisateurs de saisir des informations dans une zone qui prend en charge le retour automatique à la ligne ainsi que le défilement vertical et horizontal.
Pour créer un contrôle serveur Web TextBox multiligne
Affectez à la propriété TextMode du contrôle TextBox la valeur Multiline. Dans le code, les modes texte sont définis à l'aide de l'énumération TextMode.
Définissez la taille du contrôle en paramétrant les propriétés suivantes :
Width, avec une valeur en pixels, ou Columns, avec le nombre de caractères à afficher.
Height, avec une valeur en pixels, ou Rows, avec un nombre de lignes.
.gif "Remarque")
Remarque :Les propriétés Height et Width ne fonctionnent pas dans les navigateurs qui ne prennent pas en charge les styles de feuille de style en cascade (CSS).
La définition de ces propriétés ne limite pas le nombre de caractères ou de lignes que l'utilisateur peut entrer mais uniquement le nombre affiché. Le contrôle affiche toujours une barre de défilement verticale. Height et Width sont prioritaires sur Rows et Columns.
Remarque :Par défaut, un contrôle TextBox multiligne inclut une barre de défilement verticale. Pour masquer la barre de défilement, ajoutez l'attribut de style overflow: hidden. Par exemple, en mode HTML, la syntaxe déclarative pour le contrôle peut se présenter comme suit :
<asp:TextBox id="TextBox1" style="Z-INDEX: 101; LEFT: 56px; OVERFLOW: hidden; POSITION: absolute; TOP: 72px" TextMode="MultiLine"></asp:TextBox>Définissez le retour automatique à la ligne en paramétrant la propriété Wrap du contrôle. Si la valeur est true, le texte fait l'objet d'un retour automatique à la ligne (sans insertion de caractères de retour chariot/changement de ligne). Si la valeur est false, le texte ne fait pas l'objet d'un retour automatique à la ligne et l'utilisateur doit appuyer sur ENTRÉE pour commencer une nouvelle ligne, ce qui insère un caractère de retour chariot/changement de ligne. L'affectation de la valeur false à la propriété Wrap entraîne l'affichage d'une barre de défilement horizontale par le contrôle.
Remarque :La propriété MaxLength n'a aucun effet dans une zone de texte multiligne.