Syntaxe déclarative du contrôle serveur Web Label
Mise à jour : novembre 2007
Affiche un texte statique sur une page Web Forms et permet de le manipuler par programme.
<asp:Label
AccessKey="string"
AssociatedControlID="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CssClass="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
Visible="True|False"
Width="size"
/>
Notes
Utilisez le contrôle Label pour afficher du texte dans un emplacement défini sur la page. Contrairement à un texte statique, le texte affiché peut être personnalisé en définissant la propriété Text.
.gif "Remarque Attention") Attention : |
|---|
Le texte n'est pas codé au format HTML avant d'être affiché dans le contrôle Label. Il est ainsi possible d'incorporer du script dans les balises HTML dans le texte. Si les valeurs du contrôle proviennent des entrées d'utilisateur, veillez à valider les valeurs pour permettre d'empêcher les failles en matière de sécurité. |
Pour plus d'informations sur les propriétés et événements du contrôle serveur Web Label, consultez la documentation de la classe Label.
Exemple
L'exemple suivant illustre la création d'un contrôle Label sur une page Web.
.gif "Remarque") Remarque : |
|---|
L'exemple de code suivant utilise un modèle de code à 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="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 Button_Click(Sender As Object, e As EventArgs)
Label1.Text = Server.HtmlEncode(Text1.Text)
End Sub
</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>
<%@ 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 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>