Literal.Text Eigenschaft
Definition
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 die im Literal Steuerelement angezeigte Beschriftung ab oder legt sie fest.
public:
property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.Bindable(true)]
public string Text { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, setPublic Property Text As StringEigenschaftswert
Die im Literal Steuerelement angezeigte Beschriftung.
Implementiert
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie die Eigenschaft verwenden, um die Text im Literal Steuerelement angezeigte Beschriftung programmgesteuert zu ändern.
Hinweis
Im folgenden Beispiel 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>Literal Example</title>
<script runat="server">
void ButtonClick(Object sender, EventArgs e)
{
Literal1.Text="Welcome to ASP.NET!!";
}
</script>
</head>
<body>
<form id="form1" 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="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>Literal Example</title>
<script runat="server">
Sub ButtonClick(sender As Object, e As EventArgs)
Literal1.Text="Welcome to ASP.NET!!"
End Sub
</script>
</head>
<body>
<form id="form1" 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>
Hinweise
Verwenden Sie die Text Eigenschaft, um die im Literal Steuerelement angezeigte Beschriftung anzugeben oder zu bestimmen. Auf diese Weise können Sie die Beschriftung zur Laufzeit programmgesteuert ändern.
Die Beschriftung ist HTML-decodiert, je nachdem, wie Sie dieser Eigenschaft einen Wert zuweisen. Wenn Sie einen Wert über ein Attribut des Literal Steuerelements zuweisen, ist der Wert HTML decodiert, bevor er angezeigt wird. Beispielsweise <asp:Literal id="DisplayLiteral" Text="A B"/> wird im Browser als "A B" gerendert. Wenn Sie diese Eigenschaft jedoch programmgesteuert festlegen oder den Text zwischen den öffnenden und schließenden Tags des Steuerelements platzieren, ist die Beschriftung nicht HTML decodiert. Beispielsweise <asp:Literal id="DisplayLiteral"> A B </asp:Literal> wird als "A B" gerendert.
Vorsicht
Dieses Steuerelement kann verwendet werden, um Benutzereingaben anzuzeigen, die bösartige Clientskripts enthalten können. Überprüfen Sie alle Informationen, die von einem Client auf ausführbare Skripts, SQL-Anweisungen oder anderen Code gesendet werden, bevor Sie sie in Ihrer Anwendung anzeigen. ASP.NET stellt eine Eingabeanforderungsüberprüfungsfunktion bereit, um Skripts und HTML in der Benutzereingabe zu blockieren. Überprüfungsserversteuerelemente werden auch zur Bewertung der Benutzereingabe bereitgestellt. Weitere Informationen finden Sie unter Validation Server Control Syntax.
Der Wert dieser Eigenschaft kann automatisch mithilfe eines Designertools in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute"Globalisierung und Lokalisierung".
