Opciones de configuración de ejecución para globalización

Artículo
11/30/2023

Modo invariable

Determina si una aplicación de .NET Core se ejecuta en modo invariable de globalización sin tener acceso a los datos y el comportamiento concretos de la referencia cultural.
Si se omite esta configuración, la aplicación se ejecuta con acceso a los datos culturales. Esto es equivalente a establecer el valor en false.
Para obtener más información, vea Modo invariable de globalización de .NET Core.

	Nombre de valor	Valores
runtimeconfig.json	`System.Globalization.Invariant`	`false`: acceder a los datos culturales. `true`: ejecutar en modo invariable.
Propiedad de MSBuild	`InvariantGlobalization`	`false`: acceder a los datos culturales. `true`: ejecutar en modo invariable.
Variable del entorno	`DOTNET_SYSTEM_GLOBALIZATION_INVARIANT`	`0`: acceder a los datos culturales. `1`: ejecutar en modo invariable.

Ejemplos

Archivo runtimeconfig.json:

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

archivo runtimeconfig.template.json:

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

Archivo del proyecto:

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

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

</Project>

Rangos de años de la era

Determina si las comprobaciones de rango para los calendarios que admiten varias eras son relajadas o si las fechas que desbordan el intervalo de fechas de una era producen un elemento ArgumentOutOfRangeException.
Si se omite este valor, las comprobaciones de intervalo son distendidas. Esto es equivalente a establecer el valor en false.
Para obtener más información, vea Calendarios, eras e intervalos de fechas: comprobaciones de intervalos relajadas.

	Nombre de valor	Valores
runtimeconfig.json	`Switch.System.Globalization.EnforceJapaneseEraYearRanges`	`false`: comprobaciones de intervalos relajadas. `true`: los desbordamientos causan una excepción.
Variable del entorno	N/D	N/D

Esta configuración no tiene una propiedad específica de MSBuild. Sin embargo, puede agregar un elemento RuntimeHostConfigurationOption de MSBuild en su lugar. Use el nombre de la configuración runtimeconfig.json como valor del atributo Include. Para obtener un ejemplo, consulte propiedades de MSBuild.

Análisis de fechas japonesas

Determina si una cadena cuyo valor del año contiene "1" o "Gannen" se analiza correctamente o si solo se admite "1".
Si se omite este valor, las cadenas que contienen "1" o "Gannen" como año se analizan correctamente. Esto es equivalente a establecer el valor en false.
Para obtener más información, vea Representación de fechas en calendarios con varias eras.

	Nombre de valor	Valores
runtimeconfig.json	`Switch.System.Globalization.EnforceLegacyJapaneseDateParsing`	`false`: se admite "Gannen" o "1". `true`: solo se admite "1".
Variable del entorno	N/D	N/D

Formato de año japonés

Determina si el primer año de una era de calendario japonés tiene formato "Gannen" o un número.
Si se omite esta configuración, el primer año tiene formato "Gannen". Esto es equivalente a establecer el valor en false.
Para obtener más información, vea Representación de fechas en calendarios con varias eras.

	Nombre de valor	Valores
runtimeconfig.json	`Switch.System.Globalization.FormatJapaneseFirstYearAsANumber`	`false`: dar formato como "Gannen". `true`: dar formato como número.
Variable del entorno	N/D	N/D

NLS

Determina si .NET usa las API de globalización de compatibilidad con el idioma nacional (NLS) o componentes internacionales para Unicode (ICU) para aplicaciones de Windows. .NET 5 y las versiones posteriores usan las API de globalización de ICU de forma predeterminada en la actualización de mayo de 2019 de Windows 10 y versiones posteriores.
Si se omite esta configuración, .NET usa las API de globalización de ICU forma predeterminada. Esto es equivalente a establecer el valor en false.
Para obtener más información, consulte Las API de globalización usan bibliotecas ICU en Windows.

	Nombre de valor	Valores	Inclusión
runtimeconfig.json	`System.Globalization.UseNls`	`false` -Uso de API de globalización de ICU `true` -Uso de API de globalización de NLS	.NET 5
Variable del entorno	`DOTNET_SYSTEM_GLOBALIZATION_USENLS`	`false` -Uso de API de globalización de ICU `true` -Uso de API de globalización de NLS	.NET 5

Referencias culturales predefinidas

Determina si las aplicaciones pueden crear referencias culturales distintas a la referencia cultural invariable si está habilitado el modo invariable de globalización.
Si se omite este valor, .NET restringe la creación de referencias culturales en el modo invariable de globalización. Esto es equivalente a establecer el valor en true.
Para obtener más información, vea Creación de referencia cultural y asignación de casos en el modo invariable de globalización.

	Nombre de valor	Valores	Inclusión
runtimeconfig.json	`System.Globalization.PredefinedCulturesOnly`	`true`: en el modo invariable de globalización, no permite la creación de ninguna referencia cultural, excepto la invariable. `false`: permite la creación de cualquier referencia cultural.	.NET 6
Propiedad de MSBuild	`PredefinedCulturesOnly`	`true`: en el modo invariable de globalización, no permite la creación de ninguna referencia cultural, excepto la invariable. `false`: permite la creación de cualquier referencia cultural.	.NET 6
Variable del entorno	`DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY`	`true`: en el modo invariable de globalización, no permite la creación de ninguna referencia cultural, excepto la invariable. `false`: permite la creación de cualquier referencia cultural.	.NET 6