Opções de configuração de runtime 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, consulte o modo invariável de globalização do .NET Core.

Exemplos

Arquivo runtimeconfig.json:

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

Arquivo runtimeconfig.template.json:

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

Arquivo de projeto:

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

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

</Project>

Intervalos de ano de era

• Determina se as verificações de intervalo para calendários que dão suporte a várias eras são relaxadas ou se as datas que excedem o intervalo de datas de uma era lançam um ArgumentOutOfRangeException.
• Se você omitir essa configuração, as verificações de intervalo estarão descontraídas. Isso é equivalente a definir o valor como false.
• Para obter mais informações, consulte Calendários, eras e intervalos de datas: verificações de intervalo descontraídas.

Essa definição de configuração não tem uma propriedade específica do MSBuild. No entanto, você pode adicionar um item RuntimeHostConfigurationOption do MSBuild. Use o nome da configuração runtimeconfig.json como o valor do atributo Include. Para ver um exemplo, confira Propriedades do MSBuild.

Análise de data em japonês

• Determina se uma cadeia de caracteres que contém "1" ou "Gannen" como o ano analisa 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, consulte Representar datas em calendários com várias eras.

Essa definição de configuração não tem uma propriedade específica do MSBuild. No entanto, você pode adicionar um item RuntimeHostConfigurationOption do MSBuild. Use o nome da configuração runtimeconfig.json como o valor do atributo Include. Para ver um exemplo, confira Propriedades do MSBuild.

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, consulte Representar datas em calendários com várias eras.

Essa definição de configuração não tem uma propriedade específica do MSBuild. No entanto, você pode adicionar um item RuntimeHostConfigurationOption do MSBuild. Use o nome da configuração runtimeconfig.json como o valor do atributo Include. Para ver um exemplo, confira Propriedades do MSBuild.

NLS

• Determina se o .NET usa o NLS (National Language Support) ou as APIs de globalização de Componentes Internacionais para Unicode (UTI) para aplicativos do Windows. O .NET 5 e versões posteriores usam APIs de globalização da UTI por padrão no Windows 10 May 2019 Update e versões posteriores.
• Se você omitir essa configuração, o .NET usará APIs de globalização da UTI por padrão. Isso é equivalente a definir o valor como false.
• Para obter mais informações, consulte As APIs de Globalização usam bibliotecas de UTI no Windows.

Essa definição de configuração não tem uma propriedade específica do MSBuild. No entanto, você pode adicionar um item RuntimeHostConfigurationOption do MSBuild. Use o nome da configuração runtimeconfig.json como o valor do atributo Include. Para ver um exemplo, confira Propriedades do MSBuild.

Culturas predefinidas

• Configura se os aplicativos podem criar culturas diferentes da cultura invariável quando o modo invariável de globalização 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 caso no modo invariável de globalização.