LiteralMode LiteralMode LiteralMode LiteralMode Enum

Определение

Указывает, как выводится содержимое элемента управления Literal.Specifies how the content in a Literal control is rendered.

public enum class LiteralMode
public enum LiteralMode
type LiteralMode = 
Public Enum LiteralMode
Наследование

Поля

Encode Encode Encode Encode 2

Содержимое текстового элемента управления кодируется в формате HTML.The literal control's contents are HTML-encoded.

PassThrough PassThrough PassThrough PassThrough 1

Содержимое текстового элемента управления не изменяется.The literal control's contents are not modified.

Transform Transform Transform 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 PassThroughсвойству значение.After 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. При отображении Transformэлементауправления для устройства или браузера, поддерживающего HTML или XHTML, указание дает то же поведение, что и при указании PassThrough. LiteralWhen 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 Например, если свойство содержит содержимое <XYZ> <XYZ>Test</XYZ>, теги и </XYZ> удаляются при отправке текста Test на устройство или в браузер.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.

Применяется к

Дополнительно