globalização Element (ASP.NET Settings Schema)

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

Define as configurações de globalização de um aplicativo.

<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

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Attributes

Atributo	Descrição
culture	Atributo opcional. Especifica a cultura padrão para processar solicitações de entrada da Web. Para seqüências de caracteres culturais válidas, consulte System.Globalization.CultureInfo. Esse atributo também pode ser definido como auto.
enableClientBasedCulture	Atributo opcional. Esse atributo não está em uso no momento.
fileEncoding	Atributo opcional. Especifica a codificação padrão para analisar o arquivo. asax,. asmx e. aspx. Arquivos Unicode e UTF-8, o que são salvas com o byte order mark prefixo são reconhecidos automaticamente, independentemente do valor para este atributo.
requestEncoding	Atributo opcional. Especifica a codificação considerada de cada solicitação de entrada, incluindo dados publicados e a seqüência de caracteres de consulta. Se a solicitação vier com um cabeçalho de solicitação que contém um Accept-Charset atributo, ela substitui esse atributo na configuração. A codificação padrão é UTF-8, que é especificada na globalization seção no arquivo Machine. config que foi criado quando o.NET Framework foi instalado. Se a codificação de solicitação não for especificado em um arquivo Machine. config ou Web. config, codificação padrão para a configuração de localidade de opções regionais do computador. Em aplicativos de servidor único, este atributo e o responseEncoding atributo deve ser o mesmo. Para casos menos comuns (onde as codificações de servidor padrão são diferentes aplicativos de vários servidores), você pode variar a solicitação e a codificação de resposta usando arquivos locais da Web. config.
responseEncoding	Atributo opcional. Especifica a codificação do conteúdo das respostas. A codificação padrão é UTF-8, que é especificada na globalization seção no arquivo Machine. config que foi criado quando o.NET Framework foi instalado. Se a codificação de resposta não for especificado em um arquivo Machine. config ou Web. config, codificação padrão para a configuração de localidade de opções regionais do computador. Em aplicativos de servidor único, este atributoe o responseEncoding atributo deve ser o mesmo. Para casos menos comuns (onde as codificações de servidor padrão são diferentes aplicativos de vários servidores), você pode variar a solicitação e a codificação de resposta usando arquivos locais da Web. config.
uiCulture	Atributo opcional. Especifica a cultura padrão para processar pesquisas de recurso dependente de localidade. Para seqüências de caracteres culturais válidas, consulte System.Globalization.CultureInfo. Esse atributo também pode ser definido como auto.

Child Elements

Nenhum.

Parent Elements

Elemento	Descrição
configuration	Especifica o elemento de raiz em todos os arquivos de configuração que é usado pelo Common Language Runtime e os aplicativos .NET Framework.
system.web	Especifica o elemento raiz para o ASP.Seção de configuração de rede.

Remarks

Se o servidor ou aplicativo fileEncoding configuração do atributo está configurada para usar UTF-16 e UTF-16 é não a codificação é usada para uma página. aspx no escopo do arquivo de configuração, a saída que é enviada ao navegador do cliente será corrompida e possivelmente pode exibir o código-fonte da página. Certifique-se de que o configurado fileEncoding valor coincide com a codificação que está sendo usado na página.

Configuração padrão

O seguinte padrão globalization elemento não está explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, ele é a configuração padrão que é retornada pelo aplicativo.

<globalization requestEncoding="utf-8" 
               responseEncoding="utf-8" 
               fileEncoding="" 
               culture="" 
               uiCulture="" 
               enableClientBasedCulture="false" 
               responseHeaderEncoding="utf-8" 
               resourceProviderFactoryType="" 
               enableBestFitResponseEncoding="false" />

Exemplo

O exemplo de código a seguir demonstra como especificar a solicitação padrão e a codificação de resposta para um aplicativo ASP.NET Visual Basic.

<configuration>
   <system.web>
      <globalization 
         requestEncoding="iso-8859-1"
         responseEncoding="iso-8859-1"/>
   </system.web>
</configuration>

Element Information

Manipulador da seção de configuração	System.Web.Configuration.GlobalizationSection
Membro de configuração	SystemWebSectionGroup.Globalization
Locais configuráveis	Machine.config Web. config de nível de raiz Web. config de nível de aplicativo Directory–level virtuais ou físicas Web. config
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0 A Microsoft.NET Framework versão 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Tasks

How to: Lock ASP.NET Configuration Settings

Reference

System. Web Element (ASP.NET Settings Schema)

<configuration> Elemento

System.Configuration

System.Web.Configuration

Concepts

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Other Resources

Encoding Base Types

ASP.NET Configuration Files

ASP.Definições de configuração de rede

Configurações gerais (ASP.NET)

ASP.NET Configuration API