Literal Web 服务器控件概述

更新：2007 年 11 月

可以使用 Literal Web 服务器控件作为页面上其他内容的容器。

本主题包括：

方案

Literal 最常用于向页面中动态添加内容。

返回页首

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

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

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

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

Literal 控件支持 Mode 属性，该属性用于指定控件对您所添加的标记的处理方式。可以将 Mode 属性设置为以下值：

Transform. 将对添加到控件中的任何标记进行转换，以适应请求浏览器的协议。如果向使用 HTML 外的其他协议的移动设备呈现内容，此设置非常有用。
PassThrough. 添加到控件中的任何标记都将按原样呈现在浏览器中。
Encode. 将使用 HtmlEncode 方法对添加到控件中的任何标记进行编码，这会将 HTML 编码转换为其文本表示形式。例如，<b> 标记将呈现为 <b>。当希望浏览器显示而不解释标记时，编码将很有用。编码对于安全也很有用，有助于防止在浏览器中执行恶意标记。显示来自不受信任的源的字符串时推荐使用此设置。有关更多信息，请参见如何：通过对字符串应用 HTML 编码在 Web 应用程序中防止脚本侵入。

下表列出了与 Literal 控件相关的类。

成员	Description
Literal	控件的主类。

返回页首