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 |
可选特性。 为处理传入的 Web 请求指定默认的区域性。 若要查看有效的区域性字符串，请参见 System.Globalization.CultureInfo。 此特性还可以设置为 auto。 |
enableClientBasedCulture |
可选特性。 目前不使用此特性。 |
fileEncoding |
可选特性。 为 .aspx、.asmx 和 .asax 文件分析指定默认编码。 无论此特性的值是什么，用 byte order mark 前缀保存的 Unicode 和 UTF-8 文件都将被自动识别。 |
requestEncoding |
可选特性。 指定每一传入请求的假定的编码，包括已传递的数据和查询字符串。 如果请求附带包含一个 Accept-Charset 特性的请求标头，它将重写配置中的该特性。 默认编码为 UTF-8，该编码在 Machine.config 文件（在安装 .NET Framework 时创建）的 globalization 节中指定。 如果在 Machine.config 或 Web.config 文件中未指定请求编码，则编码默认为计算机的“区域选项”区域设置。 在单服务器应用程序中，此特性和 responseEncoding 特性应该相同。 对于不常见的情况（默认服务器编码不同的多服务器应用程序），可以使用本地 Web.config 文件改变请求和响应编码。 |
responseEncoding |
可选特性。 指定响应的内容编码。 默认编码为 UTF-8，该编码在 Machine.config 文件（在安装 .NET Framework 时创建）的 globalization 节中指定。 如果在 Machine.config 或 Web.config 文件中未指定响应编码，则编码默认为计算机的“区域选项”区域设置。 在单服务器应用程序中，此特性和 responseEncoding 特性应该相同。 对于不常见的情况（默认服务器编码不同的多服务器应用程序），可以使用本地 Web.config 文件改变请求和响应编码。 |
uiCulture |
可选特性。 为处理依赖于区域设置的资源搜索指定默认的区域性。 若要查看有效的区域性字符串，请参见 System.Globalization.CultureInfo。 此特性还可以设置为 auto。 |
子元素
无。
父元素
元素 |
说明 |
|---|---|
configuration |
指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。 |
system.web |
为 ASP.NET 配置节指定根元素。 |
备注
如果服务器或应用程序的 fileEncoding 特性设置已配置为使用 UTF-16，但 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 Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0 Microsoft .NET Framework 版本 1.0、1.1 或 2.0 Microsoft Visual Studio 2003 或 Visual Studio 2005 |