Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch
Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

Label.Text-Eigenschaft

Ruft den Textinhalt des Label-Steuerelements ab oder legt diesen fest.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

[BindableAttribute(true)]
[PersistenceModeAttribute(PersistenceMode.InnerDefaultProperty)]
public virtual string Text { get; set; }
<asp:Label Text="String" />

Eigenschaftswert

Typ: System.String
Der Textinhalt des Steuerelements. Der Standardwert ist String.Empty.

Implementiert

ITextControl.Text

Mithilfe der Text-Eigenschaft können Sie den Textinhalt des Label-Steuerelements angeben oder bestimmen. Diese Eigenschaft wird i. d. R. verwendet, um den im Label-Steuerelement angezeigten Text programmgesteuert anzupassen.

Die Text-Eigenschaft kann HTML-Code enthalten. Ist dies der Fall, wird das HTML unverändert an den Browser übergeben, wo es als Markup und nicht als Text interpretiert wird. Wenn beispielsweise HTML-Markup im Browser als reiner Text anzeigt werden soll, können Sie die HtmlEncode-Methode verwenden, wie im Beispiel für die Klassenübersicht dargestellt. Sie können anstelle des Literal-Steuerelements auch das Label-Steuerelement verwenden und die Mode-Eigenschaft auf Encode festlegen.

HinweisHinweis

Wenn Sie die Text-Eigenschaft festlegen, werden alle andere Steuerelemente im Label-Steuerelement gelöscht.

SicherheitshinweisSicherheitshinweis

Dieses Steuerelement kann für die Anzeige von Benutzereingaben verwendet werden, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellt die ASP.NET-Seite sicher, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen hierzu finden Sie unter Übersicht über Skriptangriffe.

Wenn der Wert dieser Eigenschaft festgelegt ist, kann er mithilfe eines Designertools automatisch in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und ASP.NET-Globalisierung und -Lokalisierung.

Diese Eigenschaft ist die Standardeigenschaft, an die sich ein ControlParameter-Objekt zur Laufzeit bindet. Weitere Informationen finden Sie unter ControlValuePropertyAttribute, ControlParameter und Verwenden von Parametern für Datenquellen-Steuerelemente.

Das folgende Beispiel veranschaulicht, wie eine neue Instanz des Label-Steuerelements erstellt und dessen Text-Eigenschaft festgelegt werden.

HinweisHinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine Code-Behind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.


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


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Anzeigen: