Общие сведения о серверном веб-элементе управления Localize
Обновлен: Ноябрь 2007
Серверный веб-элемент управления Localize позволяет отображать локализованный текст в отдельной области на странице.
В этом разделе рассматриваются следующие темы:
Общие сведения
Примеры кода
Ссылка на класс
Дополнительные ресурсы
Базовые сведения
Элемент управления Localize идентичен серверному веб-элементу управления Literal и подобен серверному веб-элементу управления Label. Хотя с помощью элемента управления Label к отображаемому тексту можно применить стиль, элемент управления Localize для этого не предназначен. Свойство Text, унаследованное из элемента управления Literal, позволяет программным образом управлять текстом, отображаемым в элементе управления Localize.
Кодировка содержимого
Элемент управления Localize поддерживает свойство Mode, которое определяет, как элемент управления обрабатывает разметку, которая к нему добавляется. Свойство Mode может принимать следующие значения.
Transform Любая разметка, которую добавляют к элементу управления, преобразуется для соответствия протоколу запрашивающего обозревателя. Такую установку удобно использовать при отображении содержимого на мобильных устройствах, которые используют отличный от HTML протокол.
PassThrough Вся разметка, добавляемая в элемент управления, отображается в виде, необходимом обозревателю.
Encode Вся разметка, добавляемая в элемент управления, кодируется посредством метода HtmlEncode, который преобразует кодировку HTML в свое текстовое представление. Например, тег <b> отображается как <b>. Если необходимо просто отображать разметку в обозревателе, а не интерпретировать ее, то удобнее использовать кодировку. Кодировка также полезна для обеспечения безопасности и помощи в предотвращении выполнения небезопасной разметки в обозревателе. Рекомендуется ее использовать при отображении строк, полученных из непроверенных источников. Дополнительные сведения см. в разделе Практическое руководство. Защита от использования сценариев в веб-приложениях с помощью применения кодирования HTML к строкам.
Локализация текста при помощи строк ресурсов
При помощи расширенного или укороченного выражения в качестве значения свойства можно создавать локализованные строки в свойстве Text элемента управления Localize. Выражения оцениваются при помощи строк, указанных в RESX-файлах источника.
Создавайте RESX-файлы в папках с именем App_GlobalResources и App_LocalResources в корневом каталоге приложения. Если необходимо локализовать строки для нескольких языков, то можно создать дополнительные RESX-файлы с включенной в них информацией о языке и региональных параметрах. Например, для французской версии ресурса файл будет называть ExampleLocalizedStrings.fr.resx.
Дополнительные сведения о выражениях см. в разделе Общие сведения о выражениях ASP.NET. Дополнительные сведения о файлах ресурсов см. в разделе Локализация веб-страниц ASP.NET с использованием ресурсов. Пример кода, в котором используются регулярные выражения в элементе управления Localize, содержится в разделе Декларативный синтаксис серверного веб-элемента управления Localize.
К началу
Примеры кода
К началу
Ссылки на классы
В следующей таблице перечислены классы, связанные с элементом управления Localize.
Член |
Описание |
|---|---|
Основной класс элемента управления. |
К началу
См. также
Основные понятия
Общие сведения о выражениях ASP.NET