Literal.Text Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft die im Literal-Steuerelement angezeigte Beschriftung ab oder legt diese 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, set
Public Property Text As String

Eigenschaftswert

String

Die im Literal-Steuerelement angezeigte Beschriftung.

Implementiert

Text
Attribute
BindableAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Text -Eigenschaft verwendet wird, um die im Literal Steuerelement angezeigte Beschriftung programmgesteuert zu ändern.

Hinweis

Das folgende Beispiel verwendet das Einzeldateicodemodell und 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>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. Dadurch können Sie die Beschriftung programmgesteuert zur Laufzeit ä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, wird der Wert html-decodiert, bevor er angezeigt wird. <asp:Literal id="DisplayLiteral" Text="A&nbsp;B"/> Beispielsweise 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, wird die Beschriftung nicht HTML-decodiert. <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> Beispielsweise wird als "A B" gerendert.

Achtung

Dieses Steuerelement kann verwendet werden, um Benutzereingaben anzuzeigen, die möglicherweise schädliche Clientskripts enthalten. Ü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 bietet eine Funktion zur Überprüfung von Eingabeanforderungen zum Blockieren von Skripts und HTML in Benutzereingaben. Validierungsserversteuerelemente werden auch bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax der Validierungsserversteuerung.

Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.

Gilt für:

Weitere Informationen