LiteralMode 枚举

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

指定 Literal 控件中的内容如何呈现。

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
继承
Object
ValueType
Enum
LiteralMode

字段

Encode 2

对文本控件的内容进行 HTML 编码。
PassThrough 1

不修改文本控件的内容。
Transform 0

移除文本控件中不受支持的标记语言元素。 如果文本控件在支持 HTML 或 XHTML 的浏览器上呈现，则不修改控件的内容。

示例

以下示例演示如何设置 Literal.Mode 属性。 它最初在控件的声明性语法中设置为 Encode 。 加载页面后，用户可以单击按钮将 Mode 属性设置为 PassThrough。 这会导致 属性的内容 Literal.Text 呈现方式不同。

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Literal.Mode Property Example</title>
<script runat="Server">
       
        Sub PassThroughButton_Click(ByVal sender As Object, ByVal e As EventArgs)
   
            Literal1.Mode = LiteralMode.PassThrough
            
            Label1.Text = "The contents of the Literal.Text property " + _
                          "passed through to the browser:"
           
        End Sub
     
   </script>
</head>
<body>
    <form id="Form1" runat="server">
        
        <h3>Literal.Mode Property Example</h3>        
                             
        <asp:Label ID="Label1"
            Text="The HTML-encoded contents of the Literal.Text property:"
            runat="server">     
        </asp:Label><br /><br />
        
        <asp:Literal ID="Literal1"
            Mode="Encode"
            Text= "<b>bold</b><br/><i>italic</i><br/>"          
            runat="server">
        </asp:Literal>
       
        <hr />
       
        <asp:Button ID="PassThroughButton"
            Text="Pass Through Mode"
            OnClick="PassThroughButton_Click"
            runat="server">
        </asp:Button>
         
    </form>
</body>
</html>

注解

LiteralMode枚举表示可以指定控件中Literal内容的呈现方式的模式。 属性 Literal.Mode 使用这些枚举值来设置 属性内容 Literal.Text 的行为。

如果指定 PassThrough，则属性的 Literal.Text 整个内容将传递到设备或浏览器，而无需进行任何修改。 例如，如果 Literal.Text 属性包含标记 <hr> ，则无论是否受支持，它都会发送到所有设备和浏览器。

如果指定 Encode，则 属性的内容 Text 在呈现之前将转换为 HTML 编码的字符串。 例如，如果 Literal.Text 属性包含标记 <hr> ，则会将其转换为 &lt;hr&gt; 并发送到设备或浏览器。

如果指定 Transform，则 Literal.Text 属性的呈现行为取决于要呈现的标记的类型。 Literal为支持 HTML 或 XHTML 的设备或浏览器呈现控件时，指定 Transform 会生成与指定 PassThrough相同的行为。 属性的所有标记和元素 Literal.Text 都为请求浏览器呈现。

Literal当控件呈现为 HTML 或 XHTML 以外的标记语言（如 WML 或 cHTML）时，可以使用 Transform 值来删除不受支持的标记元素。 在这种情况下，不会为控件呈现在目标标记语言中不支持的属性的任何标记语言元素 Literal.Text 。 例如，如果 Literal.Text 属性包含 <hr> 标记，则会在内容发送到 WML 设备之前删除该标记。 如果不支持的标记包含内容，则仅删除标记，并将内容发送到设备或浏览器。 例如，如果 Literal.Text 属性包含内容 <XYZ>Test</XYZ>，则在<XYZ>将文本Test发送到设备或浏览器时，将删除 和 </XYZ> 标记。

适用于

另请参阅