Label.Text Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit le contenu texte du Label contrôle.
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, setPublic Overridable Property Text As StringValeur de propriété
Contenu texte du contrôle. La valeur par défaut est Empty.
Implémente
- Attributs
Exemples
L’exemple suivant montre comment créer une instance du Label contrôle et définir sa Text propriété.
Note
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é inchangé au navigateur, où il est possible qu’il soit interprété comme un balisage et non comme du texte. Si vous souhaitez que le navigateur affiche le balisage HTML en texte brut, vous pouvez utiliser la HtmlEncode méthode, comme illustré dans l’exemple de vue d’ensemble de la classe. Vous pouvez également utiliser le Literal contrôle au lieu du Label contrôle et définir la Mode propriété Encodesur .
Note
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 de sécurité potentielle. Par défaut, ASP.NET pages web valident que l’entrée utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des exploits 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.
