Общие сведения о серверном веб-элементе управления Literal
Обновлен: Ноябрь 2007
Серверный веб-элемент управления Literal можно использовать в качестве контейнера для другого содержимого страницы.
В этом разделе рассматриваются следующие темы:
Сценарии
Базовые сведения
Примеры кода
Ссылка на классы
Сценарии
Элемент управления Literal чаще всего используется при динамическом добавлении содержимого на страницу.
К началу
Базовые сведения
Элемент управления Literal представляет один из нескольких вариантов добавления содержимого на страницу. Для статического содержимого можно напрямую добавлять разметку на страницу в виде HTML без необходимости применения контейнера. Однако для добавления содержимого динамически необходимо добавлять содержимое в контейнер. Типичными контейнерами являются элементы управления Label, Literal, Panel и PlaceHolder.
Элемент управления Literal отличается от элемента управления Label тем, что Literal не может добавлять в текст элементы HTML. (элемент управления Label отображает элемент span). Соответственно, элемент управления Literal не поддерживает атрибуты стилей, включая атрибуты положения. Тем не менее, элемент управления Literal позволяет указывать, применяется ли к содержимому кодирование.
Элементы управления Panel и PlaceHolder отображаются в виде элементов div, формирующих отдельные блоки на странице, в отличие от встраиваемой отрисовки, которая используется элементами управления Label и Literal.
В общем случае элемент управления Literal следует использовать тогда, когда необходимо отобразить текст и элементы управления непосредственно на странице без дополнительной разметки.
Кодирование содержимого элемента управления Literal
Элемент управления Literal поддерживает свойство Mode, которое определяет, как элемент управления обрабатывает разметку, которая к нему добавляется. Свойство Mode может принимать следующие значения:
Transform. Любая разметка, которая добавляется в элемент управления, преобразуется в соответствии с протоколом запрашивающего обозревателя. Этот параметр полезен при отрисовке содержимого на мобильных устройствах, которые используют протокол, отличный от HTML.
PassThrough. Вся разметка, добавляемая в элемент управления, отображается в обозревателе без изменений.
Encode. Вся разметка, добавляемая в элемент управления, кодируется с помощью метода HtmlEncode, который преобразует кодировку HTML в ее текстовое представление. Например, тег <b> отображается как <b>. Если необходимо отображать разметку в обозревателе, а не интерпретировать ее, то лучше использовать кодирование. Кодирование также полезно в силу соображений безопасности, поскольку оно помогает предотвратить исполнение вредоносной разметки в обозревателе. Ее рекомендуется использовать при отображении строк из непроверенного источника. Дополнительные сведения см. в разделе Практическое руководство. Защита от использования сценариев в веб-приложениях с помощью применения кодирования HTML к строкам.
Примеры кода
Практическое руководство. Добавление серверных веб-элементов управления Literal на страницу веб-форм
Ссылка на классы
В следующей таблице перечислены классы, связанные с элементом управления Literal.
Член |
Описание |
|---|---|
Основной класс элемента управления. |
К началу