Элемент globalization (схема параметров ASP.NET)
Настраивает параметры глобализации приложения.
<globalization
enableClientBasedCulture="true|false"
requestEncoding="any valid encoding string"
responseEncoding="any valid encoding string"
fileEncoding="any valid encoding string"
responseHeaderEncoding = "any valid encoding string"
resourceProviderFactoryType = string
enableBestFitResponseEncoding = "true|false"
culture="any valid culture string"
uiCulture="any valid culture string"/>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние и родительские элементы.
Атрибуты
Атрибут |
Описание |
|---|---|
culture |
Необязательный атрибут. Задает язык и региональные параметры по умолчанию для обработки входящих веб-запросов. Допустимые значения строк языка и региональных параметров см. в разделе System.Globalization.CultureInfo. Этому атрибуту также может быть присвоено значение auto. |
enableClientBasedCulture |
Необязательный атрибут. Этот атрибут не используется в этом случае. |
fileEncoding |
Необязательный атрибут. Задает кодировку по умолчанию, используемую для анализа файлов .aspx, .asmx и .asax. Файлы в формате Юникод и UTF-8, сохраненные с префиксом byte order mark, будут распознаваться автоматически независимо от значения атрибута этого атрибута. |
requestEncoding |
Необязательный атрибут. Указывает предполагаемую кодировку каждого входящего запроса, включая отправленные данные и строку запроса. Если запрос приходит с заголовком, содержащим атрибут Accept-Charset, то он переопределяет указанное в конфигурации значение этого атрибута. Кодировкой по умолчанию является UTF-8, указанная в разделе globalization, включенном в созданный при установке .NET Framework файл Machine.config. Если кодировка запроса не указана ни в файле Machine.config, ни в файле Web.config, то используется кодировка по умолчанию из региональных настроек языка и стандартов, указанных для данного компьютера. Для односерверных приложений значения этого атрибута и атрибута responseEncoding должны совпадать. Для более редкого случая (многосерверных приложений с различными серверными кодировками по умолчанию) кодировку запроса и ответного сообщения можно изменить с помощью локальных файлов Web.config. |
responseEncoding |
Необязательный атрибут. Определяет кодировку содержимого ответных сообщений. Кодировкой по умолчанию является UTF-8, указанная в разделе globalization, включенном в созданный при установке .NET Framework файл Machine.config. Если кодировка ответа не указана ни в файле Machine.config, ни в файле Web.config, то используется кодировка по умолчанию из региональных настроек языка и стандартов, указанных для данного компьютера. Для односерверных приложений значения этого атрибута и атрибута responseEncoding должны совпадать. Для более редкого случая (многосерверных приложений с различными серверными кодировками по умолчанию) кодировку запроса и ответного сообщения можно изменить с помощью локальных файлов Web.config. |
uiCulture |
Необязательный атрибут. Задает язык и региональные параметры по умолчанию для обработки зависящих от языковых стандартов запросов по поиску ресурсов. Допустимые значения строк языка и региональных параметров см. в разделе System.Globalization.CultureInfo. Этому атрибуту также может быть присвоено значение auto. |
Дочерние элементы
Отсутствует.
Родительские элементы
Элемент |
Описание |
|---|---|
configuration |
Задает корневой элемент любого файла конфигурации, используемого средой CLR и приложениями платформы .NET Framework. |
system.web |
Определяет корневой элемент для раздела конфигурации ASP.NET. |
Заметки
Если для сервера или приложения атрибут fileEncoding настроен для использования кодировки UTF-16, и данная кодировка не используется для страницы .aspx в области действия файла конфигурации, то отправляемый обозревателю клиента выходной поток будет поврежден, а в обозревателе может отобразиться исходный код страницы. Следует убедиться в том, что настроенное значение fileEncoding соответствует кодировке, используемой на странице.
Конфигурация по умолчанию
Следующий установленный по умолчанию элемент globalization не задается явно ни в файле Machine.config, ни в корневом файле Web.config. Однако приложение возвращает конфигурацию, используемую по умолчанию.
<globalization requestEncoding="utf-8"
responseEncoding="utf-8"
fileEncoding=""
culture=""
uiCulture=""
enableClientBasedCulture="false"
responseHeaderEncoding="utf-8"
resourceProviderFactoryType=""
enableBestFitResponseEncoding="false" />
Пример
В следующем примере для приложения ASP.NET задается кодировка по умолчанию для запроса и ответного сообщения.
<configuration>
<system.web>
<globalization
requestEncoding="iso-8859-1"
responseEncoding="iso-8859-1"/>
</system.web>
</configuration>
Сведения об элементе
Обработчик раздела конфигурации |
|
Член конфигурации |
|
Настраиваемые расположения |
Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения Файл Web.config уровня виртуального или физического каталога |
Требования |
Microsoft IIS версии 5.0, 5.1 или 6.0 Microsoft .NET Framework версии 1.0, 1.1 или 2.0 Microsoft Visual Studio 2003 или Visual Studio 2005 |
См. также
Задачи
Пошаговое руководство. Отключение параметров конфигурации ASP.NET
Ссылки
Элемент system.web (схема параметров ASP.NET)
Основные понятия
Общие сведения о конфигурационном ASP.NET
Серверные веб-элементы управления ASP.NET и возможности обозревателей
Настройка обеспечения безопасности ASP.NET
Другие ресурсы
Параметры конфигурации ASP.NET