globalization Element (ASP.NET Settings Schema)

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

Atributos e elementos

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

Atributos

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 de Unicode e UTF-8 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 assumida para 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 a 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 um arquivo Machine. config ou Web. config, codificação padrão 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 a 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 um arquivo Machine. config ou Web. config, codificação padrão 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.

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.

Elementos filho

Nenhum.

Elementos pai

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.

Comentários

Se o servidor ou aplicativo fileEncoding Configuração do atributo está configurada para usar UTF-16 e UTF-16 não é a codificação que é usado 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 correspondências de valor, a codificação que está sendo usada na página.

Configuração padrão

O seguinte padrão globalization é o elemento não explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, é 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>

Informações do elemento

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

Virtual ou física directory–level Web. config

Requisitos

De da (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

Tarefas

Como: Bloquear definições de configuração ASP.NET

Referência

system.web Element (ASP.NET Settings Schema)

<configuration> Element

System.Configuration

System.Web.Configuration

Conceitos

Codificando Tipos Base

Visão geral da configuração ASP.NET

Controles de servidor Web do ASP.NET e recursos do navegador

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

Arquivos de configuração ASP.NET

ASP.NET Configuration Settings

General Configuration Settings (ASP.NET)

API de Configuração do ASP.NET