Språk

Label.Text Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger textinnehållet i Label kontrollen.

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

Egenskapsvärde

String

Kontrollens textinnehåll. Standardvärdet är Empty.

Implementeringar

Text
Attribut
BindableAttribute PersistenceModeAttribute

Exempel

I följande exempel visas hur du skapar en ny instans av Label kontrollen och anger dess Text egenskap.

Note

Följande kodexempel använder kodmodellen med en fil och kanske inte fungerar korrekt om den kopieras direkt till en kod bakom-fil. Det här kodexemplet måste kopieras till en tom textfil som har ett .aspx-tillägg. Mer information om kodmodellen Web Forms finns i ASP.NET Web Forms Page Code Model.

<%@ 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>

Kommentarer

Använd egenskapen Text för att ange eller fastställa textinnehållet i Label kontrollen. Den här egenskapen används ofta för att programmatiskt anpassa texten som visas i Label kontrollen.

Egenskapen Text kan innehålla HTML. Om den gör det skickas HTML-koden oförändrad till webbläsaren, där den kan tolkas som markering och inte som text. Om du vill att webbläsaren ska visa HTML-kod som oformaterad text kan du använda HtmlEncode metoden, som du ser i exemplet för klassöversikten. Du kan också använda Literal kontrollen i stället för Label kontrollen och ange Mode egenskapen till Encode.

Note

Om du Text anger egenskapen rensas alla andra kontroller som finns i Label kontrollen.

Important

Den här kontrollen kan användas för att visa användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.

Värdet för den här egenskapen kan när den anges sparas automatiskt i en resursfil med hjälp av ett designerverktyg. Mer information finns i LocalizableAttribute och ASP.NET Globalisering och lokalisering.

Den här egenskapen är standardegenskapen som ett ControlParameter objekt binder till vid körning. Mer information finns i ControlValuePropertyAttribute, ControlParameteroch Använda parametrar med datakällans kontroller för filtrering.

Gäller för