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 в декларативном синтаксисе для элемента управления . После загрузки страницы пользователь может нажать кнопку, чтобы присвоить свойству Mode значение PassThrough. Это приводит к тому, что содержимое Text свойства отрисовывается по-разному.

Примечание

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

<%@ 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> тег, оно преобразуется &lt;Hr&gt; в и отправляется на устройство или в браузер.

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

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

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

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