Sdílet prostřednictvím

Literal.Text Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví titulek zobrazený v ovládacím Literal prvku.

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

Hodnota vlastnosti

String

Titulek zobrazený v ovládacím Literal prvku.

Implementuje

Text
Atributy
BindableAttribute

Příklady

Následující příklad ukazuje, jak pomocí Text vlastnosti programově změnit titulek zobrazený v ovládacím Literal prvku.

Poznámka

Následující příklad používá model kódu s jedním souborem a nemusí správně fungovat, pokud je zkopírován přímo do souboru kódu na pozadí. Tento příklad kódu musí být zkopírován do prázdného textového souboru, který má příponu .aspx. Další informace o modelu kódu webových formulářů najdete v tématu ASP.NET model kódu stránky webových formulářů.


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

Poznámky

Text Pomocí vlastnosti určete nebo určete titulek zobrazený v ovládacím Literal prvku. To vám umožní programově změnit titulek za běhu.

Titulek je dekódován html v závislosti na tom, jak této vlastnosti přiřadíte hodnotu. Pokud přiřadíte hodnotu prostřednictvím atributu Literal ovládacího prvku, hodnota se před zobrazením dekóduje HTML. Například se <asp:Literal id="DisplayLiteral" Text="A&nbsp;B"/> v prohlížeči vykreslí jako "A B". Pokud však tuto vlastnost nastavíte programově nebo umístěním textu mezi levou a pravou značku ovládacího prvku, titulek není dekódován html. Například se vykreslí <asp:Literal id="DisplayLiteral"> A&nbsp;B </asp:Literal> jako "A B".

Upozornění

Tento ovládací prvek lze použít k zobrazení vstupu uživatele, který může zahrnovat škodlivý klientský skript. Než ho zobrazíte v aplikaci, zkontrolujte všechny informace odesílané klientem kvůli spustitelnému skriptu, příkazům SQL nebo jinému kódu. ASP.NET poskytuje funkci ověření vstupní žádosti, která blokuje skript a html v uživatelském vstupu. K dispozici jsou také ovládací prvky ověřovacího serveru pro posouzení vstupu uživatele. Další informace najdete v tématu Syntaxe ovládacího prvku ověřovacího serveru.

Hodnota této vlastnosti, pokud je nastavená, se dá automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace najdete v tématech LocalizableAttributeGlobalizace a lokalizace.

Platí pro

Viz také