ASP:LABEL |
ASP : Etiquette |
|---|---|
| ASP.NET | |
Syntaxe
|
<ASP:LABEL paramètres> </ASP:LABEL> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| AccessKey=valeur | Ce paramètre de balise permet d'indiquer un touche de raccourci à associer avec cette balise. | ||
| AssociatedControlID=valeur | Ce paramètre de balise permet d'indiquer l'identificateur de contrôle associé avec cette balise. | ||
| 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. | ||
| 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. | ||
| 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. | ||
| 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 à afficher dans cette balise. | ||
| ToolTip=valeur | Ce paramètre de balise permet d'indiquer l'info-bulle. | ||
| 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. | ||
Description
Cette balise permet de définir une étiquette pour un message.
Remarques
- Le contrôle <asp:Label> est utilisé pour afficher du texte sur une page Web. Il fonctionne comme un élément d'affichage passif, souvent utilisé pour présenter des messages, des titres ou des résultats dynamiques.
- La propriété essentielle de ce contrôle est Text, contenant le contenu textuel visible par l'utilisateur. Cette valeur peut être définie statiquement dans le code HTML ou dynamiquement dans le code-behind.
- Le Label doit inclure l'attribut runat="server" pour pouvoir être manipulé par le serveur. Cela permet de modifier son texte ou ses attributs à tout moment lors du cycle de vie de la page.
- Il est très souvent utilisé pour afficher des messages d'erreur, des retours de validation, des résultats calculés ou tout autre contenu que l'on souhaite rendre lisible à l'utilisateur sans interaction directe.
- Le contrôle Label peut être stylisé grâce à des propriétés comme Font, ForeColor, BackColor, ou encore avec des classes CSS via CssClass, afin d'adapter son apparence à l'interface graphique.
- Il est également possible de rendre conditionnel l'affichage d'un Label en modifiant sa propriété Visible dans le code serveur. Cela permet d'afficher un message uniquement dans certains cas.
- Un Label peut être utilisé dans un formulaire pour étiqueter un champ (comme une boîte de texte), mais contrairement à la balise <label> de HTML, il ne crée pas automatiquement un lien fonctionnel avec un contrôle de formulaire.
- La propriété AssociatedControlID, introduite avec ASP.NET 2.0, permet néanmoins de lier un Label à un contrôle de saisie, comme une TextBox, pour améliorer l'accessibilité et la navigation clavier.
- Le texte affiché par un Label peut contenir du HTML si la propriété Text est définie depuis le code et que le contenu est construit dynamiquement (mais attention aux failles XSS).
- Il peut aussi être utilisé pour afficher des données récupérées depuis une base de données ou une API, comme un nom d'utilisateur, une date de connexion ou un état de commande.
- Les Label sont fréquemment utilisés pour afficher les résultats d'une opération, par exemple après avoir cliqué sur un bouton : "Données enregistrées avec succès", "Erreur : saisie incorrecte",...
- Il est également courant d'avoir plusieurs Labels dans une page, chacun lié à une logique différente. Il est donc important de bien nommer les ID pour garder un code propre et maintenable.
- Un Label peut aussi être utilisé dans un Repeater, un GridView ou un autre contrôle de données pour afficher dynamiquement une valeur provenant d'un enregistrement.
- Il ne déclenche aucun événement par lui-même, car il s'agit d'un simple affichage. Cependant, il peut réagir indirectement à des événements déclenchés par d'autres contrôles via le code-behind.
- En AJAX, un Label placé dans un UpdatePanel peut être mis à jour dynamiquement sans recharger toute la page. Cela permet de créer des interfaces réactives avec retour immédiat.
Exemple
Voici un exemple permettant d'afficher 3 étiquettes :
- <%@ 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:Label id="label1" runat="server">Etiquette 1</asp:Label><br />
- <asp:Label id="label2" runat="server">Etiquette 2</asp:Label><br />
- <asp:Label id="label3" runat="server">Etiquette 3</asp:Label><br />
- </form>
- </body>
- </html>
on obtiendra le résultat semblable suivant :
|
Etiquette 1 Etiquette 2 Etiquette 3 |
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017