globalização elemento (esquema configurações ASP.NET)

Artigo
08/25/2010

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

<configuration> Element
System.Web elemento (esquema configurações ASP.NET)
globalização elemento (esquema configurações 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"/>

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 o processamento de solicitações da Web de entrada. 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 .aspx, .asmx e. asax análise do arquivo. Arquivos Unicode e UTF-8, 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 assumida de cada solicitação de entrada, incluindo dados postados e a seqüência de caracteres da 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 no globalization seção na computador. arquivo de configuração que foi criado quando o .NET estrutura foi instalado. Se a codificação de solicitação não for especificado um Machine.config ou arquivo Web.config, codificação padrão é a configuração de localidade opções regionais do computador. Em aplicativos com um único servidor, este atributo e o responseEncoding atributo deve ser o mesmo. No caso menos comuns (aplicativos de vários servidores onde as codificações de servidor padrão são diferentes), você pode variar a solicitação e a codificação de resposta usando arquivos Web.config locais.
responseEncoding	Atributo opcional. Especifica a codificação do conteúdo das respostas. A codificação padrão é UTF-8, que é especificada no globalization seção na computador. arquivo de configuração que foi criado quando o .NET estrutura foi instalado. Se a codificação de resposta não for especificado em um arquivo Machine.config ou Web.config, codificação padrão a configuração de localidade opções regionais do computador. Em aplicativos de servidor único, este atributo e o responseEncoding atributo deve ser o mesmo. No caso menos comuns (aplicativos de vários servidores onde as codificações de servidor padrão são diferentes), você pode variar a solicitação e a codificação de resposta usando arquivos Web.config locais.
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 referente à seção de configuração do ASP.NET.

Comentários

Se o servidor ou aplicativo fileEncoding configuração do atributo é 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 enviada ao navegador do cliente irá estar corrompida e possivelmente pode exibir o código de fonte da página. Certifique-se de que o configurado fileEncoding valor corresponde a codificação que está sendo usado na página.

Configuração padrão

O seguinte padrão globalization elemento não está configurado explicitamente na computador. arquivo de configuração ou na Web raiz. arquivo de configuração. 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 da resposta de um aplicativo ASP.NET.

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

Informações do elemento

Manipulador de seção de configuração	System.Web.Configuration.GlobalizationSection
Configuração de membro	SystemWebSectionGroup.Globalization
Locais configuráveis	Machine.config Web.config de nível de raiz Web.config de nível de aplicativo Virtual ou físico diretório–nível Web.config
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0 O Microsoft .NET estrutura versão 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Partilhar via

globalização elemento (esquema configurações ASP.NET)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Conceitos

Referência

Outros recursos

Recursos adicionais