Vue d'ensemble du contrôle serveur Web Label
Mise à jour : novembre 2007
Le contrôle serveur Web Label vous permet de définir du texte par programme dans une page Web ASP.NET.
Cette rubrique contient les sections suivantes :
Scénarios
Fonctionnalités
Contexte
Exemples de code
Référence de classe
Scénarios
Vous utilisez généralement le contrôle Label lorsque vous souhaitez modifier du texte dans la page au moment de l'exécution, par exemple en réponse à un clic sur un bouton.
Retour au début
Fonctionnalités
Vous pouvez définir le texte du contrôle Label au moment du design ou au moment de l'exécution dans un programme. Vous pouvez aussi lier la propriété Text du contrôle Label à une source de données pour afficher les informations de la base de données sur une page.
Retour au début
Contexte
Vous pouvez utiliser le contrôle Label pour servir de légende active devant un contrôle TextBox ou autre. Les utilisateurs peuvent alors appuyer sur une touche d'accès rapide pour passer au contrôle dont le contrôle Label est la légende. Pour plus d'informations, consultez Comment : utiliser des contrôles serveur Web Label en tant que légendes.
Le contrôle Label offre un moyen d'afficher du texte dans une page Web ASP.NET. D'autres options incluent les éléments suivants :
Balisage HTML Si vous souhaitez afficher du texte statique, vous pouvez le présenter en utilisant du code HTML ; vous n'avez alors pas besoin d'un contrôle Label. Utilisez un contrôle Label uniquement si vous avez besoin de modifier le contenu ou les autres caractéristiques du texte dans le code serveur.
Contrôle Literal Comme le contrôle Label, le contrôle Literal permet d'afficher du texte par programme dans la page. Toutefois, le contrôle Literal ne prend pas en charge les propriétés de style ni les thèmes ou les apparences.
Utilisation de contrôles Label dans les contrôles de liste
Le contrôle Label est souvent utilisé dans les contrôles serveur Web de liste (contrôles Repeater, DataList, GridView, DetailsView et FormView) pour afficher des informations en lecture seule à partir d'une base de données. La stratégie habituelle consiste à ajouter un contrôle Label à un modèle pour l'un de ces contrôles. Vous liez alors le contrôle Label à une source de données. Pour plus d'informations sur les modèles, consultez Modèles de contrôles serveur Web ASP.NET.
Sécurité et contrôle Label
Vous pouvez affecter à la propriété Text du contrôle Label une chaîne quelconque, y compris des chaînes qui contiennent des balises. Si la chaîne contient une balise, le contrôle Label interprète celle-ci. Par exemple, si vous affectez à la propriété Text la valeur <b>Test</b>, le contrôle Label restitue le mot Test en caractères gras.
Pour éviter les problèmes de sécurité, tels que le risque d'injection de script, n'affectez pas à la propriété Text une chaîne qui contient des balises provenant d'une source non fiable. Si vous n'avez pas confiance en la source de la chaîne que vous utilisez pour la propriété Text, vous devez coder la chaîne. Pour plus d'informations, consultez Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTML.
Retour au début
Exemples de code
Comment : ajouter des contrôles serveur Web Label à une page Web Forms (Visual Studio)
Comment : utiliser des contrôles serveur Web Label en tant que légendes
Retour au début
Référence de classe
Le tableau suivant répertorie les classes relatives au contrôle Label.
Membre |
Description |
|---|---|
Classe principale du contrôle. |
Retour au début