Compartilhar via


Opções de configuração de tempo de execução para globalização

Modo invariável

  • Determina se um aplicativo .NET Core é executado no modo invariável de globalização sem acesso a dados e comportamentos específicos da cultura.
  • Se você omitir essa configuração, o aplicativo será executado com acesso a dados culturais. Isso é equivalente a definir o valor como false.
  • Para obter mais informações, confira Modo invariável de globalização do .NET Core.
Nome da configuração Valores
runtimeconfig.json System.Globalization.Invariant false – Acesso a dados culturais
true – Executar no modo invariável
Propriedade do MSBuild InvariantGlobalization false – Acesso a dados culturais
true – Executar no modo invariável
Variável de ambiente DOTNET_SYSTEM_GLOBALIZATION_INVARIANT 0 – Acesso a dados culturais
1 – Executar no modo invariável

Exemplos

Arquivo runtimeconfig.json:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Globalization.Invariant": true
      }
   }
}

Arquivo de projeto:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <InvariantGlobalization>true</InvariantGlobalization>
  </PropertyGroup>

</Project>

Intervalos de ano de era

Nome da configuração Valores
runtimeconfig.json Switch.System.Globalization.EnforceJapaneseEraYearRanges false – Verificações de intervalo relaxadas
true – Os estouros causam uma exceção
Variável de ambiente N/D N/D

Análise de data japonesa

  • Determina se uma cadeia de caracteres que contém "1" ou "Gannen" como o ano é analisada com êxito ou se há suporte apenas para "1".
  • Se você omitir essa configuração, as cadeias de caracteres que contêm "1" ou "Gannen" como o ano serão analisadas com êxito. Isso é equivalente a definir o valor como false.
  • Para obter mais informações, confira Representar datas em calendários com várias eras.
Nome da configuração Valores
runtimeconfig.json Switch.System.Globalization.EnforceLegacyJapaneseDateParsing false – Há suporte para "Gannen" ou "1"
true – Há suporte somente para "1"
Variável de ambiente N/D N/D

Formato de ano japonês

  • Determina se o primeiro ano de uma era do calendário japonês é formatado como "Gannen" ou como um número.
  • Se você omitir essa configuração, o primeiro ano será formatado como "Gannen". Isso é equivalente a definir o valor como false.
  • Para obter mais informações, confira Representar datas em calendários com várias eras.
Nome da configuração Valores
runtimeconfig.json Switch.System.Globalization.FormatJapaneseFirstYearAsANumber false – Formatar como "Gannen"
true – Formatar como número
Variável de ambiente N/D N/D

NLS

  • Determina se o .NET usa o NLS (suporte ao idioma nacional) ou as APIs de globalização do ICU (Componentes Internacionais para Unicode) para aplicativos do Windows. O .NET 5 e versões posteriores usam APIs de globalização de ICU por padrão na atualização de maio de 2019 do Windows 10 e nas versões posteriores.
  • Se você omitir essa configuração, o .NET usará APIs de globalização de ICU por padrão. Isso é equivalente a definir o valor como false.
  • Para obter mais informações, confira As APIs de globalização usam bibliotecas de ICU no Windows.
Nome da configuração Valores Introduzida
runtimeconfig.json System.Globalization.UseNls false – Usar APIs de globalização de ICU
true – Usar APIs de globalização de NLS
.NET 5
Variável de ambiente DOTNET_SYSTEM_GLOBALIZATION_USENLS false – Usar APIs de globalização de ICU
true – Usar APIs de globalização de NLS
.NET 5

Culturas predefinidas

Nome da configuração Valores Introduzida
runtimeconfig.json System.Globalization.PredefinedCulturesOnly true – No modo invariável de globalização, não permitir a criação de nenhuma cultura, exceto da cultura invariável.
false – Permitir a criação de qualquer cultura.
.NET 6
Propriedade do MSBuild PredefinedCulturesOnly true – No modo invariável de globalização, não permitir a criação de nenhuma cultura, exceto da cultura invariável.
false – Permitir a criação de qualquer cultura.
.NET 6
Variável de ambiente DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY true – No modo invariável de globalização, não permitir a criação de nenhuma cultura, exceto da cultura invariável.
false – Permitir a criação de qualquer cultura.
.NET 6