Literal.Mode Свойство

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает или задает значение перечисления, указывающее способ отрисовки содержимого Literal элемента управления.

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

Одно из значений LiteralMode перечисления. Значение по умолчанию — Transform.

Исключения

ArgumentOutOfRangeException

Указанный тип не является одним из значений LiteralMode перечисления.

Примеры

В следующем примере кода показано, как задать Literal свойство элемента управления Mode . Свойство Mode изначально задано Encode в декларативном синтаксисе элемента управления. После загрузки страницы пользователь может нажать кнопку, чтобы задать для свойства значение ModePassThrough. Это приводит к тому, что содержимое Text свойства будет отображаться по-другому.

Замечание

В следующем примере используется модель кода с одним файлом и может не работать правильно, если она копируется непосредственно в файл программной части. Этот пример кода должен быть скопирован в пустой текстовый файл с расширением .aspx. Дополнительные сведения о модели кода веб-форм см. в разделе ASP.NET модель кода веб-форм.

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

Mode Используйте свойство, чтобы указать способ отрисовки содержимого Literal элемента управления. Это свойство задается с помощью одного из значений LiteralMode перечисления. В следующей таблице перечислены возможные значения.

Ценность	Описание
`PassThrough`	Содержимое элемента управления не изменяется.
`Encode`	Содержимое элемента управления преобразуется в строку в кодировке HTML.
`Transform`	Неподдерживаемые элементы разметки удаляются из содержимого элемента управления. Если элемент Literal управления отображается в браузере, поддерживающем HTML или XHTML, содержимое элемента управления не изменяется.

Если указать PassThrough, все содержимое Text свойства передается устройству или браузеру без внесения изменений. Например, если Text свойство Literal элемента управления содержит <hr> тег, оно отправляется всем устройствам и браузерам независимо от того, поддерживается ли оно.

При указании Encodeсодержимое свойства Text преобразуется в строку в кодировке HTML перед отрисовкой. Например, если Text свойство Literal элемента управления содержит <hr> тег, оно преобразуется <Hr> в устройство или браузер и отправляется в него.

При указании Transformповедение Text отрисовки свойства зависит от типа отрисовки разметки. Literal При отображении элемента управления для устройства или браузера, поддерживающего HTML или XHTML, указывая Transform такое же поведение, как и при указанииPassThrough. Все теги разметки и элементы для Text свойства отображаются для запрашивающего браузера.

Literal При отображении элемента управления для языка разметки, отличного от HTML или XHTML, например WML или cHTML, можно использовать Transform значение для удаления неподдерживаемых элементов разметки. В этом случае все элементы Text языка разметки свойства, которые не поддерживаются на целевом языке разметки, не отображаются для элемента управления. Например, если Text свойство Literal элемента управления содержит <hr> тег, тег удаляется перед отправкой содержимого на устройство WML. Если неподдерживаемый тег содержит содержимое, удаляется только тег, а содержимое отправляется на устройство или браузер. Например, если Text свойство содержит содержимое <XYZ>Test</XYZ>, <XYZ> удаляются теги и </XYZ> текст "Test" отправляется на устройство или браузер.

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

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через