Literal.Text Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Titulek zobrazený v ovládacím Literal prvku.
Implementuje
- Atributy
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 se zkopíruje přímo do souboru kódu. 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 Web Forms najdete v tématu ASP.NET Web Forms Model kódu stránky.
<%@ 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 Vlastnost slouží k určení nebo určení titulku zobrazeného v ovládacím Literal prvku. To umožňuje programově změnit titulek za běhu.
Titulek je dekódovaný html v závislosti na tom, jak přiřadíte hodnotu této vlastnosti. Pokud přiřadíte hodnotu prostřednictvím atributu Literal ovládacího prvku, hodnota je před zobrazením dekódována HTML. Například <asp:Literal id="DisplayLiteral" Text="A B"/>
se 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čkou ovládacího prvku, titulek není dekódován HTML. Například <asp:Literal id="DisplayLiteral"> A B </asp:Literal>
se vykreslí jako "AB ".
Upozornění
Tento ovládací prvek lze použít k zobrazení uživatelského vstupu, který může zahrnovat škodlivý klientský skript. Před zobrazením v aplikaci zkontrolujte všechny informace odeslané z klienta pro spustitelný skript, SQL příkazy nebo jiný kód. ASP.NET poskytuje funkci ověřování vstupních požadavků pro blokování skriptu a HTML ve vstupu uživatele. K vyhodnocení vstupu uživatele se poskytují také ovládací prvky ověřovacího serveru. Další informace najdete v tématu Syntaxe ovládacího prvku ověřovacího serveru.
Hodnotu této vlastnosti lze při nastavení automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace najdete v tématech LocalizableAttribute o globalizaci a lokalizaci.