ASP.NET中Literal与Label控件的区别

426 查看

一、方案和背景

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> 标记将呈现为 <b>。当希望浏览器显示而不解释标记时,编码将很有用。编码对于安全也很有用,有助于防止在浏览器中执行恶意标记。显示来自不受信任的源的字符串时推荐使用此设置。

二、Literal和Label到底有什么区别

  label在经服务器处理后转换成客户端网页时候使用html的<span>标记为住控件,而Literal则是什么标记都不带 。

  例如:<span id="Label1">Label</span>(label的客户端代码)
        <b>脚本之家</b>(Literal的客户端代码)

  literal不可以运用样式。定位布局比较麻烦。在您要以编程方式设置文本而不添加额外的 HTML 标记时,可以向页面添加 Literal Web 服务器控件。在要向页面动态添加文本而不添加任何不属于该动态文本的元素时,Literal 控件非常有用。例如,您可以使用Literal 控件来显示从文件或流中读取的 HTML。如果要显示静态文本,则可以使用 HTML 呈现它;不需要 Literal 控件。只有在需要以编程方式呈现文本时才使用 Literal 控件。

三、如何:向 Web 窗体页添加 Literal Web 服务器控件

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

  说明: 如果想显示静态文本,可以使用 HTML 呈现它;不需要 Literal 控件。只有在需要动态更改服务器代码中的内容时才使用 Literal 控件。

  1、从工具箱的“标准”选项卡中,将 Literal 控件拖动到页面上。

  2、或者,在“属性”窗口的“行为”类别下,将 Mode 属性设置为 Transform、PassThrough 或者 Encode。Mode 属性指定该控件如何处理向其添加的任何标记。下面的示例显示一个简单网页,该页在运行时显示标题新闻。该页的主体(包括 Literal 控件)类似于下面的代码。

复制代码 代码如下:

<body>
  <form runat="server">
    <h1><asp:Literal id="Headline" runat=server mode="PassThrough"/></h1>
  </form>
</body>

  3、将代码添加到页面上以在运行时设置控件的 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.";
        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> </div>
    </form>
</body>
</html>

四、Literal 类

在网页上保留显示静态文本的位置。

  使用 System.Web.UI.WebControls.Literal 控件在网页上保留显示文本的位置。Literal 控件与 Label 控件类似,但 Literal 控件不允许对所显示的文本应用样式。可以通过设置 Text 属性,以编程方式控制在控件中显示的文本。

  警告: 此控件可用来显示用户输入,而该输入可能包含恶意的客户端脚本。在应用程序中显示从客户端发送来的任何信息之前,请检查它们是否包含可执行脚本、SQL 语句或其他代码。ASP.NET 提供输入请求验证功能以阻止用户输入中的脚本和 HTML。还提供验证服务器控件以判断用户输入。


下面的示例说明如何使用 Literal 控件显示静态文本。

  说明: 下面的示例使用单文件代码模型,如果将它直接复制到代码隐藏文件中,则它可能无法正常工作。此代码示例必须被复制到具有 .aspx 扩展名的空文本文件中。

复制代码 代码如下:

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