通过

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> 标记。

适用于

另请参阅