Literal.Text-Eigenschaft
Ruft die im Literal-Steuerelement angezeigte Beschriftung ab oder legt diese fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<LocalizableAttribute(True)> _
<BindableAttribute(True)> _
Public Property Text As String
'Usage
Dim instance As Literal
Dim value As String
value = instance.Text
instance.Text = value
[LocalizableAttribute(true)]
[BindableAttribute(true)]
public string Text { get; set; }
[LocalizableAttribute(true)]
[BindableAttribute(true)]
public:
virtual property String^ Text {
String^ get () sealed;
void set (String^ value) sealed;
}
/** @property */
public final String get_Text ()
/** @property */
public final void set_Text (String value)
public final function get Text () : String
public final function set Text (value : String)
Eigenschaftenwert
Die im Literal-Steuerelement angezeigte Beschriftung.
Hinweise
Mithilfe der Text-Eigenschaft können Sie die im Literal-Steuerelement angezeigte Beschriftung angeben oder bestimmen. Auf diese Weise können Sie die Beschriftung zur Laufzeit programmgesteuert ändern.
Die HTML-Decodierung der Beschriftung ist von der Art und Weise abhängig, in der Sie dieser Eigenschaft einen Wert zuweisen. Wenn ein Attribut des Literal-Steuerelements zum Zuweisen des Werts verwendet wird, erfolgt die HTML-Decodierung des Werts vor der Anzeige. Im Browser wird <asp:Literal id="DisplayLiteral" Text="A B"/> z. B. als "A B" dargestellt. Wenn Sie diese Eigenschaft hingegen programmgesteuert festlegen oder indem Sie den Text zwischen den öffnenden und schließenden Tags des Steuerelements einfügen, wird die Beschriftung nicht HTML-decodiert. <asp:Literal id="DisplayLiteral"> A B </asp:Literal> wird z. B. als "A B" dargestellt.
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. ASP.NET stellt ein Feature zur Anforderungsvalidierung von Eingaben bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Serversteuerelemente für die Validierung werden ebenfalls bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax von Validierungs-Serversteuerelementen.
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.
| Thema | Position |
|---|---|
| Gewusst wie: Hinzufügen von Literal-Webserversteuerelementen zu einer Web Forms-Seite | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Das folgende Beispiel veranschaulicht, wie mit der Text-Eigenschaft die im Literal-Steuerelement angezeigte Beschriftung programmgesteuert geändert wird.
Hinweis
Im folgenden Codebeispiel wird das Einfachdatei-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 runat="server">
Sub ButtonClick(sender As Object, e As EventArgs)
Literal1.Text="Welcome to ASP.NET!!"
End Sub
</script>
</head>
<body>
<form runat="server">
<h3>Literal Example</h3>
<asp:Literal id="Literal1"
Text="Hello World!!"
runat="server"/>
<br><br>
<asp:Button id="Button1"
Text="Change Literal Text"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void ButtonClick(Object sender, EventArgs e)
{
Literal1.Text="Welcome to ASP.NET!!";
}
</script>
</head>
<body>
<form runat="server">
<h3>Literal Example</h3>
<asp:Literal id="Literal1"
Text="Hello World!!"
runat="server"/>
<br><br>
<asp:Button id="Button1"
Text="Change Literal Text"
OnClick="ButtonClick"
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
Literal-Klasse
Literal-Member
System.Web.UI.WebControls-Namespace