Label.Text Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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 sie eine neue instance des Label Steuerelements erstellen und dessen Text -Eigenschaft festlegen.

Hinweis

Im folgenden Codebeispiel wird das Einzeldateicodemodell verwendet. Es funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit der Erweiterung .aspx kopiert werden. Weitere Informationen zum Web Forms Codemodell finden Sie unter ASP.NET Web Forms Seitencodemodell.

<%@ 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 Label Steuerelement angezeigten Text programmgesteuert anzupassen.

Die Text -Eigenschaft kann HTML enthalten. Wenn dies der Fall ist, wird der HTML-Code unverändert an den Browser übergeben, wobei möglicherweise als Markup und nicht als Text interpretiert wird. 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 auch das Literal -Steuerelement anstelle des Label -Steuerelements verwenden und die Mode -Eigenschaft auf Encodefestlegen.

Hinweis

Durch festlegen der Text -Eigenschaft werden alle anderen Steuerelemente gelöscht, die Label im Steuerelement enthalten sind.

Wichtig

Dieses Steuerelement kann verwendet werden, um Benutzereingaben anzuzeigen, was eine potenzielle Sicherheitsgefahr darstellt. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu 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: