LiteralMode 枚举

定义

指定 Literal 控件中的内容如何呈现。Specifies how the content in a Literal control is rendered.

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

字段

Encode 2

对文本控件的内容进行 HTML 编码。The literal control's contents are HTML-encoded.

PassThrough 1

不修改文本控件的内容。The literal control's contents are not modified.

Transform 0

移除文本控件中不受支持的标记语言元素。The literal control's unsupported markup-language elements are removed. 如果文本控件在支持 HTML 或 XHTML 的浏览器上呈现,则不修改控件的内容。If the literal control is rendered on a browser that supports HTML or XHTML, the control's contents are not modified.

示例

下面的示例演示如何设置Literal.Mode属性。The following example demonstrates how to set the Literal.Mode property. 它最初在控件的Encode声明性语法中设置为。It is initially set to Encode in the declarative syntax for the control. 加载页面后, 用户可以单击按钮, 将Mode属性设置为。 PassThroughAfter the page loads, the user can click a button to set the Mode property to PassThrough. 这会使Literal.Text属性的内容以不同的方式呈现。This causes the contents of the Literal.Text property to render differently.

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

注解

枚举表示可为Literal控件中的内容的呈现方式指定的模式。 LiteralModeThe LiteralMode enumeration represents the modes that you can specify for how the content in a Literal control is rendered. 属性使用这些枚举值来设置Literal.Text属性内容的行为。 Literal.ModeThe Literal.Mode property uses these enumeration values to set the behavior of the contents of the Literal.Text property.

如果指定PassThrough, 则会将Literal.Text属性的全部内容传递到设备或浏览器, 而不进行任何修改。If you specify PassThrough, the entire contents of the Literal.Text property are passed to the device or browser without any modifications. 例如, 如果Literal.Text属性<hr>包含标记, 则会将其发送到所有设备和浏览器, 无论它是否受支持。For example, if the Literal.Text property contains an <hr> tag, it is sent to all devices and browsers regardless of whether it is supported.

如果指定Encode, 则在Text呈现之前, 属性的内容将转换为 HTML 编码的字符串。If you specify Encode, the contents for the Text property are converted into an HTML-encoded string before rendering. 例如, 如果Literal.Text属性<hr>包含标记, 则会将其转换为&lt;hr&gt;并发送到设备或浏览器。For example, if the Literal.Text property contains an <hr> tag, it will be converted to &lt;hr&gt; and sent to the device or browser.

如果指定Transform, Literal.Text属性的呈现行为取决于所呈现的标记的类型。If you specify Transform, the rendering behavior of the Literal.Text property depends on the type of markup being rendered. 为支持 HTML 或 XHTML 的设备或浏览器呈现Transform PassThrough Literal控件时, 指定将生成与指定相同的行为。When the Literal control is rendered for a device or browser that supports HTML or XHTML, specifying Transform produces the same behavior as specifying PassThrough. 为请求浏览器呈现Literal.Text属性的所有标记和元素。All markup tags and elements for the Literal.Text property are rendered for the requesting browser.

如果为除 HTML 或 XHTML 之外的标记语言 (如 WML 或 cHTML) 呈现Transform 控件,可以使用值来删除不支持的标记元素。LiteralWhen the Literal control is rendered for a markup language other than HTML or XHTML, such as WML or cHTML, you can use the Transform value to remove unsupported markup elements. 在这种情况下, 不会为控件呈现Literal.Text在目标标记语言中不支持的属性的任何标记语言元素。In this case, any markup-language elements of the Literal.Text property that are not supported in the targeted markup language are not rendered for the control. 例如, 如果Literal.Text属性<hr>包含标记, 则会在将内容发送到 WML 设备之前删除标记。For example, if the Literal.Text property contains an <hr> tag, the tag is removed before the content is sent to a WML device. 如果不受支持的标记包含内容, 则仅删除标记, 并将内容发送到设备或浏览器。If an unsupported tag contains content, only the tag is removed and the content is sent to the device or browser. 例如, 如果Literal.Text属性包含Test内容<XYZ>Test</XYZ>, 则当文本发送<XYZ></XYZ>设备或浏览器时, 将删除和标记。For example, if the Literal.Text property contains the content <XYZ>Test</XYZ>, the <XYZ> and </XYZ> tags are removed while the text Test is sent to the device or browser.

适用于

另请参阅