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