globalization 元素（ASP.NET 设置架构）

项目
05/28/2012

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

配置应用程序的全球化设置。

<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>

元素信息

配置节处理程序	System.Web.Configuration.GlobalizationSection
配置成员	SystemWebSectionGroup.Globalization
可配置的位置	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

请参见

通过

globalization 元素（ASP.NET 设置架构）

特性和元素

特性

子元素

父元素

备注

默认配置

示例

元素信息

请参见

任务

参考

概念

其他资源

其他资源