Label.Text Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit le contenu du texte du contrôle Label.

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)]
public virtual string Text { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)>]
member this.Text : string with get, set
Public Overridable Property Text As String

Valeur de propriété

String

Texte du contrôle. La valeur par défaut est Empty.

Implémente

Text
Attributs
BindableAttribute PersistenceModeAttribute

Exemples

L’exemple suivant montre comment créer une instance du Label contrôle et définir sa Text propriété.

Notes

L’exemple de code suivant utilise le modèle de code à fichier unique et peut ne pas fonctionner correctement s’il est copié directement dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide qui a une extension .aspx. Pour plus d’informations sur le modèle de code Web Forms, consultez ASP.NET modèle de code de page Web Forms.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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" >
 <head>
    <title>Label Example</title>
<script language="C#" runat="server">
         void Button1_Click(Object Sender, EventArgs e) {
            Label l2 = new Label();
            l2.Text = "This is a new Label";
            l2.BorderStyle = BorderStyle.Solid;    
            Page.Controls.Add(l2);
         }
     </script>
 
 </head>
 <body>
     <h3>Label Example</h3>
     <form id="form1" runat="server">
 
         <asp:Button id="Button1" Text="Create and Show a Label" 
         OnClick="Button1_Click" Runat="server"/>
 
     </form>
 </body>
 </html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<!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" >
 <head>
    <title>Label Example</title>
<script language="VB" runat="server">
         Sub Button1_Click(Sender As Object, e As EventArgs)
            Dim l2 As New Label()
            l2.Text = "This is a new Label"
            l2.BorderStyle = BorderStyle.Solid
            Page.Controls.Add(l2)
         End Sub
     </script>
 
 </head>
 <body>
     <h3>Label Example</h3>
     <form id="form1" runat="server">
 
         <asp:Button id="Button1" Text="Create and Show a Label" 
         OnClick="Button1_Click" Runat="server"/>
 
     </form>
 </body>
 </html>

Remarques

Utilisez la Text propriété pour spécifier ou déterminer le contenu texte du Label contrôle. Cette propriété est couramment utilisée pour personnaliser par programmation le texte affiché dans le Label contrôle.

La Text propriété peut inclure du code HTML. Si c’est le cas, le code HTML est passé sans modification au navigateur, où est peut-être interprété comme du balisage et non comme du texte. Si vous souhaitez que le navigateur affiche le balisage HTML sous forme de texte brut, vous pouvez utiliser la HtmlEncode méthode, comme indiqué dans l’exemple pour la vue d’ensemble de la classe. Vous pouvez également utiliser le Literal contrôle au lieu du Label contrôle et définir la propriété sur ModeEncode.

Notes

La définition de la Text propriété efface tous les autres contrôles contenus dans le Label contrôle.

Important

Ce contrôle peut être utilisé pour afficher l’entrée utilisateur, qui est une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.

La valeur de cette propriété, lorsqu’elle est définie, peut être enregistrée automatiquement dans un fichier de ressources à l’aide d’un outil de concepteur. Pour plus d’informations, consultez LocalizableAttribute et ASP.NET globalisation et localisation.

Cette propriété est la propriété par défaut à laquelle un ControlParameter objet est lié au moment de l’exécution. Pour plus d’informations, consultez ControlValuePropertyAttribute, ControlParameteret Utilisation de paramètres avec des contrôles de source de données pour le filtrage.

S’applique à