Literal.Text Eigenschap

Definitie

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

Hiermee wordt het bijschrift opgehaald of ingesteld dat in het Literal besturingselement wordt weergegeven.

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

Waarde van eigenschap

String

Het bijschrift dat wordt weergegeven in het Literal besturingselement.

Implementeringen

Text
Kenmerken
BindableAttribute

Voorbeelden

In het volgende voorbeeld ziet u hoe u de Text eigenschap gebruikt om het bijschrift dat wordt weergegeven in het Literal besturingselement programmatisch te wijzigen.

Note

In het volgende voorbeeld wordt het codemodel met één bestand gebruikt en werkt dit mogelijk niet correct als het rechtstreeks naar een code-behind-bestand wordt gekopieerd. Dit codevoorbeeld moet worden gekopieerd naar een leeg tekstbestand met een .aspx-extensie. Zie ASP.NET Web Forms Page Code Model voor meer informatie over het webformuliercodemodel.


<%@ 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>

Opmerkingen

Gebruik de Text eigenschap om het bijschrift op te geven of te bepalen dat in het Literal besturingselement wordt weergegeven. Hiermee kunt u programmatisch het bijschrift wijzigen tijdens runtime.

Het bijschrift is HTML-decoderen, afhankelijk van hoe u een waarde aan deze eigenschap toewijst. Als u een waarde toewijst via een kenmerk van het Literal besturingselement, wordt de waarde gedecodeerd voordat deze wordt weergegeven. Wordt bijvoorbeeld <asp:Literal id="DisplayLiteral" Text="A&nbsp;B"/> weergegeven als 'A B' in de browser. Als u deze eigenschap echter programmatisch instelt of door de tekst tussen de openings- en eindtags van het besturingselement te plaatsen, wordt het bijschrift niet met HTML gedecodeerd. Wordt bijvoorbeeld <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> weergegeven als 'A B'.

Caution

Dit besturingselement kan worden gebruikt om gebruikersinvoer weer te geven, waaronder mogelijk schadelijk clientscript. Controleer alle informatie die wordt verzonden vanaf een client voor uitvoerbaar script, SQL-instructies of andere code voordat u deze in uw toepassing weergeeft. ASP.NET biedt een validatiefunctie voor invoeraanvragen voor het blokkeren van scripts en HTML in gebruikersinvoer. Er worden ook besturingselementen voor validatieservers geboden om gebruikersinvoer te beoordelen. Zie De syntaxis van validatieserverbesturing voor meer informatie.

De waarde van deze eigenschap, wanneer deze is ingesteld, kan automatisch worden opgeslagen in een resourcebestand met behulp van een ontwerpprogramma. Zie en LocalizableAttribute voor meer informatie.

Van toepassing op

Zie ook