globalization Element (ASP.NET Settings Schema)
Configures the globalization settings for an application.
<configuration> Element
system.web Element (ASP.NET Settings Schema)
globalization Element (ASP.NET Settings Schema)
<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"/>
Attributes and Elements
The following sections describe attributes, child elements, and parent elements.
Attributes
Attribute |
Description |
|---|---|
culture |
Optional attribute. Specifies the default culture for processing incoming Web requests. For valid culture strings, see System.Globalization.CultureInfo. This attribute can also be set to auto. |
enableClientBasedCulture |
Optional attribute. This attribute is not in use at this time. |
fileEncoding |
Optional attribute. Specifies the default encoding for .aspx, .asmx, and .asax file parsing. Unicode and UTF-8 files that are saved with the byte order mark prefix are automatically recognized, regardless of the value for this attribute. |
requestEncoding |
Optional attribute. Specifies the assumed encoding of each incoming request, including posted data and the query string. If the request comes with a request header that contains an Accept-Charset attribute, it overrides this attribute in the configuration. The default encoding is UTF-8, which is specified in the globalization section in the Machine.config file that was created when the .NET Framework was installed. If request encoding is not specified in a Machine.config or Web.config file, encoding defaults to the Regional Options locale setting for the computer. In single-server applications, this attribute and the responseEncoding attribute should be the same. For the less common case (multiple-server applications where the default server encodings are different), you can vary the request and response encoding by using local Web.config files. |
responseEncoding |
Optional attribute. Specifies the content encoding of responses. The default encoding is UTF-8, which is specified in the globalization section in the Machine.config file that was created when the .NET Framework was installed. If response encoding is not specified in a Machine.config or Web.config file, encoding defaults to the Regional Options locale setting for the computer. In single-server applications, this attribute and the responseEncoding attribute should be the same. For the less common case (multiple-server applications where the default server encodings are different), you can vary the request and response encoding by using local Web.config files. |
uiCulture |
Optional attribute. Specifies the default culture for processing locale-dependent resource searches. For valid culture strings, see System.Globalization.CultureInfo. This attribute can also be set to auto. |
Child Elements
None.
Parent Elements
Element |
Description |
|---|---|
configuration |
Specifies the root element in every configuration file that is used by the common language runtime and the .NET Framework applications. |
system.web |
Specifies the root element for the ASP.NET configuration section. |
Remarks
If the server or application fileEncoding attribute setting is configured to use UTF-16 and UTF-16 is not the encoding that is used for an .aspx page in the scope of the configuration file, the output that is sent to the client browser will be corrupted and might possibly display the source code of the page. Make sure that the configured fileEncoding value matches the encoding that is being used in the page.
Default Configuration
The following default globalization element is not explicitly configured in the Machine.config file or in the root Web.config file. However, it is the default configuration that is returned by application.
<globalization requestEncoding="utf-8"
responseEncoding="utf-8"
fileEncoding=""
culture=""
uiCulture=""
enableClientBasedCulture="false"
responseHeaderEncoding="utf-8"
resourceProviderFactoryType=""
enableBestFitResponseEncoding="false" />
Example
The following code example demonstrates how to specify the default request and response encoding for an ASP.NET application.
<configuration>
<system.web>
<globalization
requestEncoding="iso-8859-1"
responseEncoding="iso-8859-1"/>
</system.web>
</configuration>
Element Information
Configuration section handler |
|
Configuration member |
|
Configurable locations |
Machine.config Root-level Web.config Application-level Web.config Virtual or physical directory–level Web.config |
Requirements |
Microsoft Internet Information Services (IIS) version 5.0, 5.1, or 6.0 The Microsoft .NET Framework version 1.0, 1.1, or 2.0 Microsoft Visual Studio 2003 or Visual Studio 2005 |
See Also
Tasks
How to: Lock ASP.NET Configuration Settings
Reference
system.web Element (ASP.NET Settings Schema)
Concepts
ASP.NET Configuration Overview
ASP.NET Web Server Controls and Browser Capabilities
Securing ASP.NET Configuration
ASP.NET Configuration Scenarios
Other Resources
ASP.NET Configuration Settings