ASP:TEXTBOX |
ASP : Boite texte |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:TextBox paramètres> </asp:TextBox> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| AccessKey=valeur | Ce paramètre de balise permet d'indiquer un touche de raccourci à associer avec cette balise. | ||
| AutoCompleteType=valeur | Ce paramètre permet d'indiquer le type d'autocomplétion : | ||
| Constante | Description | ||
| "None" | Cette constante permet d'indiquer qu'il n'y aucun type d'autocomplétion. | ||
| "Disabled" | Cette constante permet d'indiquer que l'autocomplétion est désactivé. | ||
| "BusinessCity" | Cette constante permet d'indiquer qu'il faut utiliser les critères de ville d'affaire ou de travail pour l'autocomplétion. | ||
| "BusinessCountryRegion" | Cette constante permet d'indiquer qu'il faut utiliser les critères de pays ou région d'affaire ou de travail pour l'autocomplétion. | ||
| "BusinessFax" | Cette constante permet d'indiquer qu'il faut utiliser les critères de télécopieur d'affaire ou de travail pour l'autocomplétion. | ||
| "BusinessPhone" | Cette constante permet d'indiquer qu'il faut utiliser les critères de téléphone d'affaire ou de travail pour l'autocomplétion. | ||
| "BusinessState" | Cette constante permet d'indiquer qu'il faut utiliser les critères d'états ou de provinces d'affaire ou de travail pour l'autocomplétion. | ||
| "BusinessStreetAddress" | Cette constante permet d'indiquer qu'il faut utiliser les critères d'adresse de rue d'affaire ou de travail pour l'autocomplétion. | ||
| "BusinessUrl" | Cette constante permet d'indiquer qu'il faut utiliser les critères d'URL d'affaire ou de travail pour l'autocomplétion. | ||
| "BusinessZipCode" | Cette constante permet d'indiquer qu'il faut utiliser les critères de code postal d'affaire ou de travail pour l'autocomplétion. | ||
| "Cellular" | Cette constante permet d'indiquer qu'il faut utiliser les critères de cellulaire pour l'autocomplétion. | ||
| "Company" | Cette constante permet d'indiquer qu'il faut utiliser les critères d'entreprise pour l'autocomplétion. | ||
| "Department" | Cette constante permet d'indiquer qu'il faut utiliser les critères de département pour l'autocomplétion. | ||
| "DisplayName" | Cette constante permet d'indiquer qu'il faut utiliser les critères d'affichage de nom pour l'autocomplétion. | ||
| "Email" | Cette constante permet d'indiquer qu'il faut utiliser les critères de courriel pour l'autocomplétion. | ||
| "FirstName" | Cette constante permet d'indiquer qu'il faut utiliser les critères de prénom pour l'autocomplétion. | ||
| "Gender" | Cette constante permet d'indiquer qu'il faut utiliser les critères de genre pour l'autocomplétion. | ||
| "HomeCity" | Cette constante permet d'indiquer qu'il faut utiliser les critères de ville de la maison pour l'autocomplétion. | ||
| "HomeCountryRegion" | Cette constante permet d'indiquer qu'il faut utiliser les critères de pays et région de la maison pour l'autocomplétion. | ||
| "HomeFax" | Cette constante permet d'indiquer qu'il faut utiliser les critères de télécopieur de la maison pour l'autocomplétion. | ||
| "HomePhone" | Cette constante permet d'indiquer qu'il faut utiliser les critères de téléphone de la maison pour l'autocomplétion. | ||
| "HomeState" | Cette constante permet d'indiquer qu'il faut utiliser les critères de l'état ou de la province de la maison pour l'autocomplétion. | ||
| "HomeStreetAddress" | Cette constante permet d'indiquer qu'il faut utiliser les critères d'adresse de la maison pour l'autocomplétion. | ||
| "HomeZipCode" | Cette constante permet d'indiquer qu'il faut utiliser les critères de code postal de la maison pour l'autocomplétion. | ||
| "Homepage" | Cette constante permet d'indiquer qu'il faut utiliser les critères de page maison pour l'autocomplétion. | ||
| "JobTitle" | Cette constante permet d'indiquer qu'il faut utiliser les critères de titre de travail pour l'autocomplétion. | ||
| "LastName" | Cette constante permet d'indiquer qu'il faut utiliser les critères de nom de famille pour l'autocomplétion. | ||
| "MiddleName" | Cette constante permet d'indiquer qu'il faut utiliser les critères de nom du milieu pour l'autocomplétion. | ||
| "Notes" | Cette constante permet d'indiquer qu'il faut utiliser les critères d'une note pour l'autocomplétion. | ||
| "Office" | Cette constante permet d'indiquer qu'il faut utiliser les critères du bureau pour l'autocomplétion. | ||
| "Pager" | Cette constante permet d'indiquer qu'il faut utiliser les critères de pagette pour l'autocomplétion. | ||
| "Search" | Cette constante permet d'indiquer qu'il faut utiliser les critères de recherche pour l'autocomplétion. | ||
| AutoPostBack=valeur | Ce paramètre permet d'indiquer s'il faut poster immédiatement après entrée les données ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il ne faut pas poster. | ||
| "True" | Cette constante permet d'indiquer qu'il faut poster. | ||
| BackColor=valeur | Ce paramètre permet d'indiquer la couleur d'arrière plan de la balise. | ||
| BorderColor=valeur | Ce paramètre permet d'indiquer la couleur de bordure de la balise. | ||
| BorderStyle=valeur | Ce paramètre permet d'indiquer le style de bordure de la balise : NotSet, None, Dotted, Dashed, Solid, Double, Groove, Ridge, Inset ou Outset. | ||
| BorderWidth=valeur | Ce paramètre permet d'indiquer la largeur de la bordure de la balise. | ||
| CausesValidation=valeur | Ce paramètre permet d'indiquer s'il faut effectuer la validation ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il ne faut pas valider. | ||
| "True" | Cette constante permet d'indiquer qu'il faut valider. | ||
| Columns=valeur | Ce paramètre permet d'indiquer le nombre de colonnes du contenu. | ||
| CssClass=valeur | Ce paramètre permet d'indiquer la classe de feuille de style CSS de la balise. | ||
| Enabled=valeur | Ce paramètre permet d'indiquer si la balise doit être active ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| "True" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| EnableTheming=valeur | Ce paramètre permet d'indiquer si le thème de la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le thème de la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que le thème de la balise est affiché. | ||
| EnableViewState=valeur | Ce paramètre permet d'indiquer si le ViewState de la balise doit être activé ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le ViewState de la balise n'est pas actif. | ||
| "True" | Cette constante permet d'indiquer que le ViewState de la balise est actif. | ||
| Font-Bold=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être en gras ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas en gras. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est en gras. | ||
| Font-Italic=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être en italique ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas en italique. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est en italique. | ||
| Font-Names=valeur | Ce paramètre permet d'indiquer les noms de la police de caractères. | ||
| Font-Overline=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être surligné ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas surligné. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est surligné. | ||
| Font-Size=valeur | Ce paramètre permet d'indiquer la taille de la police de caractères de la balise : Smaller, Larger, XX-Small, X-Small, Small, Medium, Large, X-Large ou XX-Large. | ||
| Font-Strikeout=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être barré ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas barré. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est barré. | ||
| Font-Underline=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être souligné ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas souligné. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est souligné. | ||
| ForeColor=valeur | Ce paramètre permet d'indiquer la couleur de premier plan de la balise. | ||
| Height=valeur | Ce paramètre permet d'indiquer la hauteur de la balise. | ||
| ID=valeur | Ce paramètre permet d'indiquer l'identificateur de la balise. | ||
| MaxLength=valeur | Ce paramètre permet d'indiquer la longueur maximal du texte. | ||
| OnDataBinding=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de DataBinding. | ||
| OnDisposed=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de disposition. | ||
| OnInit=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement d'initialisation. | ||
| OnLoad=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de chargement. | ||
| OnPreRender=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de pré-rendu. | ||
| OnUnload=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de déchargement. | ||
| ReadOnly=valeur | Ce paramètre permet d'indiquer s'il est possible de modifier le contenu ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il est possible de modifier le contenu. | ||
| "True" | Cette constante permet d'indiquer qu'il n'est pas possible de modifier le contenu. | ||
| Rows=valeur | Ce paramètre permet d'indiquer le nombre de lignes du contenu. | ||
| runat=valeur | Ce paramètre permet d'indiquer où doit être exécuté la balise : | ||
| Constante | Description | ||
| "server" | Cette constante permet d'indiquer qu'il faut exécuter la balise du côté serveur. | ||
| SkinID=valeur | Ce paramètre permet d'indiquer l'identificateur de Skin. | ||
| Style=valeur | Ce paramètre de balise permet d'indiquer des paramètres de feuille de style associé avec cette balise. | ||
| TabIndex=valeur | Ce paramètre de balise permet d'indiquer l'ordre de sélection des champs et éléments dans un formulaire. | ||
| Text=valeur | Ce paramètre de balise permet d'indiquer le texte à côté de la case à cocher. | ||
| TextMode=valeur | Ce paramètre de balise permet d'indiquer le mode de texte. | ||
| Constante | Description | ||
| "SingleLine" | Cette constante permet d'indiquer que le contenu est une simple ligne. | ||
| "MultiLine" | Cette constante permet d'indiquer que le contenu a de multiple ligne. | ||
| "Password" | Cette constante permet d'indiquer que le contenu est mot de passe. | ||
| ToolTip=valeur | Ce paramètre de balise permet d'indiquer l'info-bulle. | ||
| ValidationGroup=valeur | Ce paramètre de balise permet d'indiquer le groupe de validation. | ||
| Visible=valeur | Ce paramètre permet d'indiquer si la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que la balise est affiché. | ||
| Width=valeur | Ce paramètre de balise permet d'indiquer la largeur de la balise. | ||
| Wrap=valeur | Ce paramètre permet d'indiquer si le texte peut être découpé ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il ne pas découper le texte. | ||
| "True" | Cette constante permet d'indiquer qu'il faut découper le texte. | ||
Description
Cette balise permet de définir une boite d'entrée de données texte.
Remarques
- Le contrôle <asp:TextBox> est utilisé pour permettre à l'utilisateur de saisir des informations textuelles. Il s'agit de l'équivalent serveur de l'élément HTML <input type="text">, avec l'avantage d'être gérable côté serveur dans le code-behind.
- Le paramètre Text permet de définir ou de récupérer le texte contenu dans la boîte. Il peut être initialisé dans la page ou modifié dynamiquement lors d'événements comme Page_Load ou Button_Click.
- La propriété TextMode est essentielle pour adapter le type de saisie : elle peut être définie sur "SingleLine" pour une ligne, "MultiLine" pour un champ de type texte étendu, ou "Password" pour masquer les caractères saisis.
- Quand TextMode="MultiLine" est utilisé, le champ s'affiche sous forme de zone de texte avec plusieurs lignes, ce qui est utile pour les commentaires, les descriptions longues ou les messages.
- Si TextMode est défini à "Password", le texte saisi par l'utilisateur sera masqué visuellement. C'est idéal pour la saisie de mots de passe, bien que le contrôle ne chiffre pas le contenu côté serveur par défaut.
- Le contrôle peut être personnalisé à l'aide de propriétés comme CssClass, Font, ForeColor, BackColor, ou encore Width et Height, pour une intégration cohérente dans la charte graphique d'un site.
- Il est possible de limiter le nombre de caractères que l'utilisateur peut saisir grâce à la propriété MaxLength. Cela permet de mieux contrôler les données avant même la validation côté serveur.
- Pour valider que l'utilisateur a bien rempli le champ, il est courant d'associer un contrôle <asp:RequiredFieldValidator> à la TextBox, s'assurant que le champ n'est pas vide à la soumission du formulaire.
- Une TextBox peut également être utilisée avec des événements comme TextChanged, déclenché quand le texte est modifié et que le focus quitte le champ. Cela peut être utile pour lancer une recherche en direct ou vérifier une donnée.
- La propriété AutoPostBack, lorsqu'elle est mise à True, permet d'envoyer immédiatement les modifications de texte vers le serveur, déclenchant ainsi des traitements sans attendre la validation globale du formulaire.
- Dans un formulaire ASP.NET, les TextBox sont automatiquement conservées entre les requêtes grâce au mécanisme du ViewState, ce qui évite de perdre les saisies après un rafraîchissement ou un postback.
- Le champ TextBox peut être désactivé à l'aide de la propriété Enabled="False" ou masqué avec Visible="False", ce qui permet de gérer dynamiquement son affichage selon le contexte de l'utilisateur.
- La propriété ReadOnly="True" empêche la modification du texte par l'utilisateur tout en gardant le champ visible. Cela peut être utile pour afficher des informations non modifiables dans un formulaire de consultation.
- Le contrôle <asp:TextBox> peut être utilisé dans des composants plus complexes comme les grilles de données (GridView) ou les panneaux de saisie (Panel), pour créer des interfaces utilisateur interactives.
- La saisie utilisateur via une TextBox doit être sécurisée contre les attaques XSS. Bien qu'ASP.NET encode automatiquement le texte affiché, il est important de filtrer les entrées côté serveur lors du traitement.
Exemple
Voici un exemple permettant d'afficher une boite d'entrée de données :
- <%@ Page Language="vb" %>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html xmlns="http://www.w3.org/1999/xhtml">
- <body>
- <form id="MonFormulaire" runat="server">
- <asp:TextBox id="TextBox1" runat="server"></asp:TextBox>
- </form>
- </body>
- </html>
on obtiendra le résultat semblable suivant :
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017