Cette documentation est archivée et n’est pas conservée.

Label, classe

Représente un contrôle web Label, qui affiche du texte sur une page Web.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

[ControlValuePropertyAttribute("Text")] 
public class Label : WebControl, ITextControl
/** @attribute ControlValuePropertyAttribute("Text") */ 
public class Label extends WebControl implements ITextControl
ControlValuePropertyAttribute("Text") 
public class Label extends WebControl implements ITextControl

Utilisez le contrôle Label pour afficher du texte dans un emplacement défini sur la page. Contrairement à du texte statique, vous pouvez personnaliser le texte affiché via la propriété Text.

Vous pouvez aussi utiliser les contrôles Literal et PlaceHolder pour afficher du texte sur la page Web Forms. Cependant, contrairement au contrôle Label, ces contrôles ne rendent pas de balises supplémentaires.

AttentionAttention

Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur qui peuvent inclure un script client malveillant. Vérifiez toutes les informations envoyées par un client pour un script exécutable, des instructions SQL ou un autre code avant de les afficher dans votre application. Vous pouvez utiliser des contrôles de validation pour vérifier les entrées d'utilisateur avant d'afficher le texte d'entrée dans un contrôle. ASP.NET fournit une fonctionnalité de validation de la demande d'entrée pour bloquer les scripts et le code HTML dans les entrées d'utilisateur. Pour plus d'informations, consultez Sécurisation de contrôles standard, Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTML et Validation des entrées d'utilisateur dans des pages Web ASP.NET.

Accessibilité

Le balisage rendu par défaut pour ce contrôle peut ne pas se conformer aux normes d'accessibilité telles que les instructions de priorité 1 d'accessibilité du contenu Web (WCAG, Web Content Accessibility Guidelines). Pour plus d'informations sur la prise en charge d'accessibilité pour ce contrôle, consultez Contrôles et accessibilité ASP.NET.

RubriqueEmplacement
Procédure pas à pas : création d'un Concepteur de contrôles de base pour un contrôle serveur Web ASP.NETCréation de contrôles ASP.NET
Procédure pas à pas : utilisation de styles de feuille de style en cascade dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : validation des entrées d'utilisateur dans une page Web FormsGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web de base dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web de base avec la séparation de code dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web Label à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une application Web accessibleGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : personnalisation d'un site Web à l'aide de thèmes dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : validation des entrées d'utilisateur dans une page Web FormsGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : création d'une page Web de base avec la séparation de code dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : personnalisation d'un site Web à l'aide de thèmes dans Visual StudioGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : création d'une application Web accessibleGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : création d'un Concepteur de contrôles de base pour un contrôle serveur WebGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer dynamiquement des modèles dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer dynamiquement des modèles dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET
Comment : personnaliser des journées dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET
Comment : utiliser des contrôles serveur Web Label en tant que légendesGénération d'applications Web ASP.NET
Comment : ajouter des contrôles serveur Web Label à une page Web FormsGénération d'applications Web ASP.NET
Procédure pas à pas : création d'un Concepteur de contrôles de base pour un contrôle serveur WebGénération d'applications Web ASP.NET dans Visual Studio
Comment : créer dynamiquement des modèles dans des contrôles serveur Web DataListGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des journées dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET dans Visual Studio
Comment : utiliser des contrôles serveur Web Label en tant que légendesGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web de base dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web Label à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des journées dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET dans Visual Studio
Comment : utiliser des contrôles serveur Web Label en tant que légendesGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web de base dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web Label à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio

L'exemple suivant illustre la création d'un contrôle Label sur une page Web.

RemarqueRemarque

L'exemple de code suivant utilise un modèle de code de fichier unique ; il est possible qu'il ne fonctionne pas correctement s'il est directement copié dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide doté d'une extension .aspx. Pour plus d'informations sur le modèle de code Web Forms, consultez Modèle de code des pages Web ASP.NET.

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>

   <script language="C#" runat="server">

      void Button_Click(Object Sender, EventArgs e) 
      {
         Label1.Text = Server.HtmlEncode(Text1.Text);
      }

   </script>

</head>

<body>

   <form id="Form1" runat="server">

      <h3>Label Example</h3>

      <asp:Label id="Label1" 
                 Text="Label Control" 
                 runat="server"/>

      <p>
        
      <asp:TextBox id="Text1" 
           Text="Copy this text to the label"
           Width="200px"  
           runat="server" />

      <asp:Button id="Button1" 
           Text="Copy" 
           OnClick="Button_Click" 
           runat="server"/>
      </p>

   </form>

</body>
</html>


  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: