Freigeben über

Label.Text Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen des Textinhalts des Label Steuerelements.

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

Eigenschaftswert

String

Der Textinhalt des Steuerelements. Der Standardwert ist Empty.

Implementiert

Text
Attribute
BindableAttribute PersistenceModeAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine neue Instanz des Label Steuerelements erstellt und seine Text Eigenschaft festgelegt wird.

Hinweis

Im folgenden Codebeispiel wird das Codemodell mit einer Datei verwendet und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei kopiert werden, die über eine .aspx Erweiterung verfügt. Weitere Informationen zum Web Forms-Codemodell finden Sie unter 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>

Hinweise

Verwenden Sie die Text Eigenschaft, um den Textinhalt des Label Steuerelements anzugeben oder zu bestimmen. Diese Eigenschaft wird häufig verwendet, um den im Steuerelement angezeigten Label Text programmgesteuert anzupassen.

Die Text Eigenschaft kann HTML enthalten. Wenn dies der Fall ist, wird der HTML-Code unverändert an den Browser übergeben, wo möglicherweise als Markup interpretiert wird und nicht als Text. Wenn der Browser HTML-Markup als Nur-Text anzeigen soll, können Sie die HtmlEncode Methode verwenden, wie im Beispiel für die Klassenübersicht gezeigt. Sie können das Literal Steuerelement auch anstelle des Steuerelements Label verwenden und die Mode Eigenschaft auf Encodefestlegen.

Hinweis

Wenn Sie die Text Eigenschaft festlegen, werden alle anderen Steuerelemente gelöscht, die Label im Steuerelement enthalten sind.

Von Bedeutung

Dieses Steuerelement kann verwendet werden, um Benutzereingaben anzuzeigen, bei denen es sich um eine potenzielle Sicherheitsrisiken handelt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.

Der Wert dieser Eigenschaft kann automatisch mithilfe eines Designertools in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und ASP.NET Globalisierung und Lokalisierung.

Diese Eigenschaft ist die Standardeigenschaft, an die ein ControlParameter Objekt zur Laufzeit gebunden wird. Weitere Informationen finden Sie unter ControlValuePropertyAttribute, ControlParameterund Verwenden von Parametern mit Datenquellensteuerelementen zum Filtern.

Gilt für: