在您要以编程方式设置文本而不添加额外的 HTML 标记时,可以向页面添加 Literal Web 服务器控件。在要向页面动态添加文本而不添加任何不属于该动态文本的元素时,Literal 控件非常有用。例如,您可以使用 Literal 控件来显示从文件或流中读取的 HTML。
注意
如果要显示静态文本,则可以使用 HTML 呈现它;不需要 Literal 控件。只有在需要以编程方式呈现文本时才使用 Literal 控件。
向 Web 窗体页添加 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 窗体页上显示静态文本。与 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>