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)
Syntax
'Declaration
<BindableAttribute(True)> _
<LocalizableAttribute(True)> _
Public Overridable Property Text As String
'Usage
Dim instance As Label
Dim value As String
value = instance.Text
instance.Text = value
[BindableAttribute(true)]
[LocalizableAttribute(true)]
public virtual string Text { get; set; }
[BindableAttribute(true)]
[LocalizableAttribute(true)]
public:
virtual property String^ Text {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_Text ()
/** @property */
public void set_Text (String value)
public function get Text () : String
public function set Text (value : String)
Eigenschaftenwert
Der Textinhalt des Steuerelements. Der Standardwert ist String.Empty.
Hinweise
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.
Hinweis
Wenn Sie die Text-Eigenschaft festlegen, werden alle andere Steuerelemente im Label-Steuerelement gelöscht.
Warnung
Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die möglicherweise böswillige Clientskripts enthalten. Überprüfen Sie alle von einem Client gesendeten Informationen auf ausführbare Skripts, SQL-Anweisungen oder anderen Code, bevor Sie sie in der Anwendung anzeigen. Mithilfe von Validierungssteuerelementen können Sie Benutzereingaben überprüfen, bevor Sie den Eingabetext in einem Steuerelement anzeigen. ASP.NET stellt ein Validierungsfeature für Eingabeaufforderungen bereit, um Skripts und HTML-Code in Benutzereingaben zu blockieren. Weitere Informationen finden Sie unter Sichern von Standardsteuerelementen, Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen und Überprüfen der Benutzereingabe in ASP.NET-Webseiten.
Der Wert dieser Eigenschaft (sofern festgelegt) kann mit einem Designertool automatisch in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und unter 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.
Beispiel
Das folgende Beispiel veranschaulicht, wie eine neue Instanz des Label-Steuerelements erstellt und dessen Text-Eigenschaft festgelegt werden.
Hinweis
Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-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="VB" AutoEventWireup="True" %>
<html>
<head>
<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 runat="server">
<asp:Button id="Button1" Text="Create and Show a Label"
OnClick="Button1_Click" Runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<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 runat="server">
<asp:Button id="Button1" Text="Create and Show a Label"
OnClick="Button1_Click" Runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>
<script language="JScript" runat="server">
function Button1_Click(Sender : Object, e : EventArgs) {
var l2 : Label = 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 runat="server">
<asp:Button id="Button1" Text="Create and Show a Label"
OnClick="Button1_Click" Runat="server"/>
</form>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Label-Klasse
Label-Member
System.Web.UI.WebControls-Namespace
Weitere Ressourcen
Label-Webserver-Steuerelement
Sichern von Standardsteuerelementen
Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen
Überprüfen der Benutzereingabe in ASP.NET-Webseiten