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

Arquivo runtimeconfig.json:

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

Arquivo de projeto:

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

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

</Project>

Determina se as verificações de intervalo de calendários com suporte a várias eras são relaxadas ou se as datas que ultrapassam o intervalo de datas de uma era geram uma ArgumentOutOfRangeException.
Se você omitir essa configuração, as verificações de intervalo ficarão relaxadas. Isso é equivalente a definir o valor como false.
Para obter mais informações, confira Calendários, eras e intervalos de datas: verificações de intervalo relaxadas.

	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

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

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

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

Configura se os aplicativos podem criar culturas diferentes da cultura invariável quando o modo invariável-inconstante está habilitado.
Se você omitir essa configuração, o .NET restringirá a criação de culturas no modo invariável de globalização. Isso é equivalente a definir o valor como true.
Para mais informações, confira Criação de cultura e mapeamento de maiúsculas e minúsculas no modo invariável de globalização.

	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