Literal.Text Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger bildtexten som visas i Literal kontrollen.

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

Egenskapsvärde

String

Bildtexten som visas i Literal kontrollen.

Implementeringar

Text
Attribut
BindableAttribute

Exempel

I följande exempel visas hur du använder Text egenskapen för att programmatiskt ändra bildtexten som visas i Literal kontrollen.

Note

I följande exempel används kodmodellen med en fil och kanske inte fungerar korrekt om den kopieras direkt till en kod bakom fil. Det här kodexemplet måste kopieras till en tom textfil som har ett .aspx-tillägg. Mer information om kodmodellen Web Forms finns i 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>

Kommentarer

Använd egenskapen Text för att ange eller fastställa bildtexten som visas i Literal kontrollen. På så sätt kan du programmatiskt ändra bildtexten vid körning.

Bildtexten är HTML-avkodad beroende på hur du tilldelar ett värde till den här egenskapen. Om du tilldelar ett värde via ett attribut för Literal kontrollen är värdet HTML-avkodat innan det visas. Till <asp:Literal id="DisplayLiteral" Text="A&nbsp;B"/> exempel återges som "A B" i webbläsaren. Men om du anger den här egenskapen programmatiskt eller genom att placera texten mellan kontrollens inledande och avslutande taggar, är beskrivningen inte HTML-avkodad. Till exempel <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> återges som "A B".

Caution

Den här kontrollen kan användas för att visa användarindata, som kan innehålla skadligt klientskript. Kontrollera all information som skickas från en klient för körbart skript, SQL-instruktioner eller annan kod innan du visar den i ditt program. ASP.NET tillhandahåller en funktion för validering av indatabegäran för att blockera skript och HTML i användarindata. Verifieringsserverkontroller tillhandahålls också för att utvärdera användarindata. Mer information finns i Verifieringsserverkontrollsyntax.

Värdet för den här egenskapen kan när den anges sparas automatiskt i en resursfil med hjälp av ett designerverktyg. Mer information finns i LocalizableAttributeglobalisering och lokalisering.

Gäller för

Se även