ASP:LITERAL |
ASP : Littéral |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:Literal paramètres> </asp:Literal /> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| 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. | ||
| ID=valeur | Ce paramètre permet d'indiquer l'identificateur de la balise. | ||
| Mode=valeur | Ce paramètre permet d'indiquer le mode de la balise : «Transform», «PassThrough» ou «Encode». | ||
| 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. | ||
| Text=valeur | Ce paramètre de balise permet d'indiquer le texte à afficher dans cette balise. | ||
| 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é. | ||
Description
Cette balise permet de définir un contrôle pouvant être utilisé afin d'obtenir des informations du serveur Web.
Remarques
- Le contrôle <asp:Literal> permet d'afficher du texte directement dans la page HTML générée, sans balise HTML autour. C'est une composante léger, souvent utilisé pour insérer dynamiquement du contenu textuel brut.
- Contrairement à d'autres contrôles comme <asp:Label>, le Literal n'ajoute aucun balisage HTML autour du texte, ce qui le rend parfait pour insérer du contenu pur dans le flux HTML.
- La propriété Text est la principale utilisée avec ce contrôle. Elle détermine le texte qui sera affiché à l'écran. Ce texte peut être assigné en statique dans le code ou dynamiquement en code-behind.
- Le paramètre Mode permet de définir comment le texte est rendu : Transform, PassThrough ou Encode. Cela affecte la façon dont le texte est inséré dans le HTML (brut, encodé,...).
- Avec Mode="Encode", les caractères spéciaux HTML sont automatiquement encodés, ce qui protège contre les injections de code ou les erreurs d'affichage dans le navigateur.
- Mode="PassThrough" insère le texte tel quel, sans modification ni encodage. Cela peut être utile pour insérer des balises HTML volontairement.
- Le Literal est fréquemment utilisé pour afficher des messages, des résultats de traitement, ou injecter dynamiquement du code HTML depuis le serveur, sans que cela ne crée d'élément HTML supplémentaire.
- Le paramètre EnableViewState détermine si le contenu du contrôle est conservé entre les postbacks. Pour un affichage temporaire non conservé, il est souvent mis à False.
- La propriété Visible permet de rendre le contrôle visible ou non à l'écran. Si Visible="False", aucun contenu ni balise n'est rendu côté client, contrairement à certains autres contrôles.
- Le Literal ne prend pas en charge le theming (apparence visuelle par Skin) de manière aussi riche que d'autres contrôles, mais on peut tout de même y appliquer un SkinID si besoin.
- La gestion des événements (OnInit, OnLoad, OnPreRender,...) permet d'exécuter du code serveur à différentes étapes du cycle de vie du contrôle, même si cela est peu utilisé pour un Literal.
- Le contrôle peut être utilisé dans des gabarits ASP.NET, comme ceux de GridView ou Repeater, pour afficher des données sans mise en forme HTML superflue.
- Le Literal est également pratique pour insérer du JavaScript ou des styles CSS à la volée, lorsqu'on veut écrire dans la page HTML directement depuis le serveur.
- Ce contrôle est très léger en termes de performance. Il est à privilégier lorsqu'on veut uniquement afficher du texte sans interaction utilisateur ou fonctionnalités supplémentaires.
- Il ne génère pas de balises supplémentaires comme <span> ou <div>, ce qui le distingue du contrôle Label et permet un rendu plus propre et minimaliste dans le DOM.
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017