2011第一个技术帖:Literal Web 服务器控件

作者: unvs 分类: ASP.NET 发布时间: 2011-02-23 20:23 ė11,597 views 6没有评论

Literal 控件无需添加任何 HTML 元素即可将静态文本呈现在网页上。可以通过服务器代码以编程方式静态控制文本。

 

注意

若要显示静态文本,可以使用 HTML 呈现它;不需要使用 Literal 控件。只有在需要更改服务器代码中的内容时才使用 Literal 控件。Literal 控件与 Label 控件类似,不同的是 Literal 控件不能用于将样式应用于显示的文本。

 

可以使用 Literal Web 服务器控件作为页面上其他内容的容器。Literal 最常用于向页面中动态添加内容

 

将 Literal 控件与其他选项进行比较
Literal 控件表示用于向页面添加内容的几个选项之一。对于静态内容,无需使用容器,可以将标记作为 HTML 直接添加到页面中。但是,如果要动态添加内容,则必须将内容添加到容器中。典型的容器有 Label 控件、Literal 控件、Panel 控件和 Placeholder 控件。

Literal 控件与 Label 控件的区别在于 Literal 控件不向文本中添加任何 HTML 元素。(Label 控件呈现一个 span 元素。)因此,Literal 控件不支持包括位置属性在内的任何样式属性。但是,Literal 控件允许指定是否对内容编码。

Panel 和 Placeholder 控件呈现为 div 元素,这将在页面中创建离散块,与 Label 和 Literal 控件进行内嵌呈现的方式不同

通常情况下,当希望文本和控件直接呈现在页面中而不使用任何附加标记时,可使用 Literal 控件。

 

在 Literal 控件中编码内容
Literal 控件支持 Mode 属性,该属性用于指定控件对您所添加的标记的处理方式。可以将 Mode 属性设置为以下值:

Transform。添加到控件中的任何标记都将进行转换,以适应请求浏览器的协议。如果向使用 HTML 外的其他协议的移动设备呈现内容,此设置非常有用。

PassThrough。添加到控件中的任何标记都将按原样呈现在浏览器中。

Encode。添加到控件中的任何标记都将使用 HtmlEncode 方法进行编码,该方法将把 HTML 编码转换为其文本表示形式。例如,<b> 标记将呈现为 &lt;b&gt;。当希望浏览器显示而不解释标记时,编码将很有用。编码对于安全也很有用,有助于防止在浏览器中执行恶意标记,显示来自不受信任的源的字符串时推荐使用此设置。有关更多信息,请参见 如何:通过对字符串应用 HTML 编码在 Web 应用程序中防止脚本侵入。

在您要以编程方式设置文本而不添加额外的 HTML 标记时,可以向页面添加 Literal Web 服务器控件。在要向页面动态添加文本而不添加任何不属于该动态文本的元素时,Literal 控件非常有用。例如,您可以使用 Literal 控件来显示从文件或流中读取的 HTML。

注意
如果要显示静态文本,则可以使用 HTML 呈现它;不需要 Literal 控件。只有在需要以编程方式呈现文本时才使用 Literal 控件。
 

向 Web 窗体页添加 Literal 控件
1.将 <asp:Literal> 元素键入页面。有关语法,请参见 Literal Web 服务器控件声明性语法。

下面的示例显示一个简单页,该页在运行时显示标题新闻。该页的主体(包括 Literal 控件)类似于下面的代码:
<body>
   <form runat="server">
      <h1><asp:Literal id="Headline" runat=server /></h1>
   </form>
</body>

2.或者,将 Mode 属性设置为 Transform、PassThrough 或 Encode。Mode 属性指定控件如何处理您添加到该控件中的标记。有关详细信息,请参见 Literal Web 服务器控件概述。

3.将代码添加到页面上以在运行时设置控件的 Text 属性。

下面的示例演示如何以编程方式设置 Literal 控件的文本和编码。该页包含一组单选按钮,允许用户在编码文本和传递文本之间选择。

注意
如果您正将 Text 属性设置为来自不受信任源的文本,则应将控件的 Mode 属性设置为 Encode,这样标记才不会形成可执行标记。有关更多信息,请参见 如何:通过对字符串应用 HTML 编码在 Web 应用程序中防止脚本侵入。
 
Visual Basic 
<%@ Page Language="VB" %>
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, _
        ByVal e As System.EventArgs)
    Literal1.Text = "This <b>text</b> is inserted dynamically."
    If radioEncode.Checked = True Then
        Literal1.Mode = LiteralMode.Encode
    ElseIf radioPassthrough.Checked = True Then
        Literal1.Mode = LiteralMode.PassThrough
    End If
End Sub
</script>

<html>
<head 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>
 

C# 
<%@ Page Language="C#" %>
<script runat="server">
    protected void Page_Load(object sender, EventArgs e)
    {
        Literal1.Text = "This <b>text</b> is inserted dynamically.";
        if (radioEncode.Checked == true)
        {
            Literal1.Mode = LiteralMode.Encode;
        }
        if(radioPassthrough.Checked
== true)
        {
            Literal1.Mode = LiteralMode.PassThrough;
        }
    }
</script>

<html>
<head 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>&nbsp;</div>
    </form>
</body>
</html>

本博文章基本上属于原创或收集整理,都是心血结晶。
欢迎转载分享,转载请注明出处,谢谢!
本文地址:2011第一个技术帖:Literal Web 服务器控件

发表评论

电子邮件地址不会被公开。 必填项已用 * 标注

您可以使用这些 HTML 标签和属性: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

Ɣ回顶部