使用 Mode 属性指定如何呈现 Literal 控件的内容。使用一个 LiteralMode 枚举值设置此属性。下表列出了可能的值。
值
说明
PassThrough
未修改控件的内容。
Encode
控件的内容转换为 HTML 编码的字符串。
Transform
从控件的内容中移除不受支持的标记语言元素。如果 Literal 控件在支持 HTML 或 XHTML 的浏览器上呈现,则不会修改该控件的内容。
如果指定 PassThrough,则 Text 属性的全部内容不经任何修改即传递给设备或浏览器。例如,如果 Literal 控件的 Text 属性包含
标记,则无论该标记是否受支持,都将传递给所有设备和浏览器。 如果指定 Encode,则 Text 属性的内容在呈现前会转换为 HTML 编码字符串。例如,如果 Literal 控件的 Text 属性包含
标记,则将该标记转换为 <Hr> 并发送到设备或浏览器。 如果指定 Transform,则 Text 属性的呈现行为取决于要呈现的标记的类型。如果 Literal 控件在支持 HTML 或 XHTML 的设备或浏览器上呈现,指定 Transform 会产生与指定 PassThrough 相同的行为。Text 属性的所有标记和元素都呈现到请求浏览器。 使用 HTML 或 XHTML 之外的标记语言(如 WML 或 cHTML)呈现 Literal 控件时,可以使用 Transform 值移除不受支持的标记元素。在此情况下,控件 Text 属性的所有不受目标标记语言支持的标记语言元素都不会呈现。例如,如果 Literal 控件的 Text 属性包含
标记,则在将内容发送到 WML 设备前移除该标记。如果不受支持的标记包含内容,则仅移除标记,而将内容发送到设备或浏览器。例如,如果 Text 属性包含内容Test ,则移除 和 标记,并将文本“Test”发送到设备或浏览器。
标记,则无论该标记是否受支持,都将传递给所有设备和浏览器。 如果指定 Encode,则 Text 属性的内容在呈现前会转换为 HTML 编码字符串。例如,如果 Literal 控件的 Text 属性包含
标记,则将该标记转换为 <Hr> 并发送到设备或浏览器。 如果指定 Transform,则 Text 属性的呈现行为取决于要呈现的标记的类型。如果 Literal 控件在支持 HTML 或 XHTML 的设备或浏览器上呈现,指定 Transform 会产生与指定 PassThrough 相同的行为。Text 属性的所有标记和元素都呈现到请求浏览器。 使用 HTML 或 XHTML 之外的标记语言(如 WML 或 cHTML)呈现 Literal 控件时,可以使用 Transform 值移除不受支持的标记元素。在此情况下,控件 Text 属性的所有不受目标标记语言支持的标记语言元素都不会呈现。例如,如果 Literal 控件的 Text 属性包含
标记,则在将内容发送到 WML 设备前移除该标记。如果不受支持的标记包含内容,则仅移除标记,而将内容发送到设备或浏览器。例如,如果 Text 属性包含内容