Literal.Mode Свойство

Определение

Получает или задает значение перечисления, определяющее порядок отрисовки содержимого для просмотра в элементе управления Literal.Gets or sets an enumeration value that specifies how the content in the Literal control is rendered.

public:
 property System::Web::UI::WebControls::LiteralMode Mode { System::Web::UI::WebControls::LiteralMode get(); void set(System::Web::UI::WebControls::LiteralMode value); };
public System.Web.UI.WebControls.LiteralMode Mode { get; set; }
member this.Mode : System.Web.UI.WebControls.LiteralMode with get, set
Public Property Mode As LiteralMode

Значение свойства

Одно из значений перечисления LiteralMode.One of the LiteralMode enumeration values. Значение по умолчанию — Transform.The default is Transform.

Исключения

Указанный тип не является одним из значений перечисления LiteralMode.The specified type is not one of the LiteralMode enumeration values.

Примеры

В следующем примере кода показано, как задать Literal Mode свойство элемента управления.The following code example demonstrates how to set a Literal control's Mode property. Изначально свойство имеет Encode значение в декларативном синтаксисе для элемента управления. ModeThe Mode property 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. Это приводит к тому, что Text содержимое свойства отображается по-другому.This causes the contents of the Text property to render differently.

Примечание

В следующем примере используется модель кода с одним файлом, которая может работать неправильно при копировании непосредственно в файл кода программной части.The following example uses the single-file code model and might not work correctly if copied directly into a code-behind file. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением. aspx.This code example must be copied into an empty text file that has an .aspx extension. Дополнительные сведения о модели кода веб-форм см. в разделе модель кода страницы веб-форм ASP.NET.For more information about the Web Forms code model, see ASP.NET Web Forms Page Code Model.

<%@ 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 элемента управления. ModeUse the Mode property to specify how the contents of a Literal control should be rendered. Это свойство задается с помощью одного LiteralMode из значений перечисления.This property is set using one of the LiteralMode enumeration values. В следующей таблице перечислены возможные значения.The following table lists the possible values.

ЗначениеValue ОписаниеDescription
PassThrough Содержимое элемента управления не изменяется.The contents of the control are not modified.
Encode Содержимое элемента управления преобразуется в строку в кодировке HTML.The contents of the control are converted to an HTML-encoded string.
Transform Неподдерживаемые элементы языка разметки удаляются из содержимого элемента управления.Unsupported markup-language elements are removed from the contents of the control. Literal Если элемент управления отображается в браузере, поддерживающем HTML или XHTML, содержимое элемента управления не изменяется.If the Literal control is rendered on a browser that supports HTML or XHTML, the control's contents are not modified.

Если указать PassThrough, все содержимое Text свойства передается на устройство или в браузер без внесения каких либо изменений.If you specify PassThrough, the entire contents of the Text property are passed to the device or browser without making any modifications. Например, если Text свойство Literal элемента управления содержит <hr> тег, оно отправляется всем устройствам и браузерам независимо от того, поддерживается он или нет.For example, if the Text property of a Literal control contains an <hr> tag, it is sent to all devices and browsers whether it is supported or not.

Если указать Encode, содержимое Text для свойства преобразуется в строку в кодировке HTML перед отрисовкой.If you specify Encode, the contents for the Text property are converted into an HTML-encoded string before rendering. Например, если Text свойство Literal элемента управления содержит <hr> тег, оно преобразуется в &lt;Hr&gt; и отправляется на устройство или в браузер.For example, if the Text property of a Literal control contains an <hr> tag, it is converted to &lt;Hr&gt; and sent to the device or browser.

Если задано Transformзначение, поведение Text отрисовки свойства зависит от типа визуализации разметки.If you specify Transform, the rendering behavior of the 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. Все теги и элементы разметки для Text свойства подготавливаются к просмотру для запрашивающего браузера.All markup tags and elements for the 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. В этом случае все элементы Text языка разметки свойства, которые не поддерживаются на целевом языке разметки, не подготавливаются для этого элемента управления.In this case, any markup language elements of the Text property that are not supported in the targeted markup language are not rendered for the control. Например, если Text свойство Literal элемента управления содержит <hr> тег, тег удаляется перед отправкой содержимого на устройство WML.For example, if the Text property of a Literal control 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. Например, если Text свойство содержит содержимое <XYZ>Test</XYZ>, <XYZ> Теги и </XYZ> удаляются, а текст "тест" отправляется на устройство или в браузер.For example, if the Text property contains the content <XYZ>Test</XYZ>, the <XYZ> and </XYZ> tags are removed, and the text "Test" is sent to the device or browser.

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

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