在您要以編程方式設定文本而不添加額外的 HTML 標籤時,可以向頁面添加 Literal Web 伺服器控制項。在要向頁面動態添加文本而不添加任何不屬於該動態文本的元素時,Literal 控制項非常有用。例如,您可以使用 Literal 控制項來顯示從檔案或流中讀取的 HTML。
注意
如果要顯示靜態文本,則可以使用 HTML 呈現它;不需要 Literal 控制項。只有在需要以編程方式呈現文本時才使用 Literal 控制項。
向 Web Form頁添加 Literal 控制項
將 <asp:Literal> 元素鍵入頁面。
下面的樣本顯示一個簡單頁,該頁在運行時顯示標題新聞。該頁的主體(包括 Literal 控制項)類似於下面的代碼:
<body>
<form runat="server">
<h1><asp:Literal id="Headline" runat=server /></h1>
</form>
</body>
或者,將 Mode 屬性設定為 Transform、PassThrough 或 Encode。Mode 屬性指定控制項如何處理您添加到該控制項中的標記。
將代碼添加到頁面上以在運行時設定控制項的 Text 屬性。
下面的樣本示範如何以編程方式設定 Literal 控制項的文本和編碼。該頁包含一組選項按鈕,允許使用者在編碼文本和傳遞文本之間選擇。
注意
如果您正將 Text 屬性設定為來自不受信任源的文本,則應將控制項的 Mode 屬性設定為 Encode,這樣標記才不會形成可執行標記。
<%@ Page Language="C#" %>
<script runat="server">
protected void Page_Load(object sender ,EventArgs e)
{
// Literal1.Text = "This <b>text</b> is inserted dynamically.";
Literal1.Text = "<script language='javascript'>alert('你中彩了!');<"+"/script>";
if(radioEncode.Checked == true)
{
Literal1.Mode = LiteralMode.Encode;
}
if(radioPassthrough.Checked == true)
{
Literal1.Mode = LiteralMode.PassThrough;
}
}
</script>
<html>
<head id="Head1" runat="server">
</head>
<body>
<form id="form1" runat="server">
<div>
<br />
<asp:RadioButton ID="radioEncode" runat="server" GroupName="LiteralMode" Checked="True"
Text="Encode" AutoPostBack="True" />
<br />
<asp:RadioButton ID="radioPassthrough" runat="server" GroupName="LiteralMode" Text="PassThrough"
AutoPostBack="True" />
<br />
<br />
<asp:Literal ID="Literal1" runat="server"></asp:Literal> </div>
</form>
</body>
</html>
當你選擇PassThrough時跳出表單,選擇Encode時原樣輸出
在頁上顯示靜態內容並允許您以編程方式對其進行操作。
<asp:Literal
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
Mode="Transform|PassThrough|Encode"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Text="string"
Visible="True|False"
/>
使用 Literal 控制項在 Web Form頁上顯示靜態文本。與 Label控制項不同的是,Literal 不允許您向其內容應用樣式。文本在 Literal 控制項中顯示之前並非 HTML 編碼形式。這使得可以在文本中的 HTML 標籤中嵌入指令碼。如果控制項的值是由使用者輸入的,請務必要對輸入值進行驗證以防止出現安全性漏洞。 樣本下面的樣本示範如何使用 Literal 控制項顯示靜態文本。<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void ButtonClick(Object sender, EventArgs e)
{
Literal1.Text="Welcome to ASP.NET!!";
}
</script>
</head>
<body>
<form 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>