LiteralMode Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает, как отображается содержимое в элементе управления Literal.
public enum class LiteralModepublic enum LiteralModetype LiteralMode = Public Enum LiteralMode- Наследование
Поля
| Имя | Значение | Описание |
|---|---|---|
| Transform | 0 | Неподдерживаемые элементы языка разметки элемента управления литерала удаляются. Если литеральный элемент управления отображается в браузере, поддерживающем HTML или XHTML, содержимое элемента управления не изменяется. |
| PassThrough | 1 | Содержимое элемента управления литерала не изменяется. |
| Encode | 2 | Содержимое элемента управления литерала закодировано в формате HTML. |
Примеры
В следующем примере показано, как задать Literal.Mode свойство. Изначально он имеет значение Encode в декларативном синтаксисе элемента управления. После загрузки страницы пользователь может нажать кнопку, чтобы задать для свойства значение ModePassThrough. Это приводит к тому, что содержимое Literal.Text свойства будет отображаться по-другому.
<%@ 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>
Комментарии
Перечисление LiteralMode представляет режимы, которые можно указать для отображения содержимого Literal элемента управления. Свойство Literal.Mode использует эти значения перечисления для задания поведения содержимого Literal.Text свойства.
Если указать PassThrough, все содержимое Literal.Text свойства передается устройству или браузеру без каких-либо изменений. Например, если Literal.Text свойство содержит <hr> тег, оно отправляется всем устройствам и браузерам независимо от того, поддерживается ли оно.
При указании Encodeсодержимое свойства Text преобразуется в строку в кодировке HTML перед отрисовкой. Например, если Literal.Text свойство содержит <hr> тег, оно будет преобразовано <hr> в устройство или браузер и отправлено в него.
При указании Transformповедение Literal.Text отрисовки свойства зависит от типа отрисовки разметки.
Literal При отображении элемента управления для устройства или браузера, поддерживающего HTML или XHTML, указывая Transform такое же поведение, как и при указанииPassThrough. Все теги разметки и элементы для Literal.Text свойства отображаются для запрашивающего браузера.
Literal При отображении элемента управления для языка разметки, отличного от HTML или XHTML, например WML или cHTML, можно использовать Transform значение для удаления неподдерживаемых элементов разметки. В этом случае все элементы Literal.Text языка разметки свойства, которые не поддерживаются на целевом языке разметки, не отображаются для элемента управления. Например, если Literal.Text свойство содержит <hr> тег, тег удаляется перед отправкой содержимого на устройство WML. Если неподдерживаемый тег содержит содержимое, удаляется только тег, а содержимое отправляется на устройство или браузер. Например, если Literal.Text свойство содержит содержимое <XYZ>Test</XYZ>, <XYZ></XYZ> а теги удаляются во время отправки текста Test на устройство или браузер.
