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 |
|
Membro de configuração |
|
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)
Conceitos
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