Opzioni di configurazione del runtime per la globalizzazione

Modalità invariante

• Determina se un'app .NET Core viene eseguita in modalità invariante per la globalizzazione senza accesso a dati e comportamenti specifici delle impostazioni cultura.
• Se si omette questa impostazione, l'app viene eseguita con accesso ai dati culturali. Equivale a impostare il valore su false.
• Per altre informazioni, vedere Modalità invariante per la globalizzazione di .NET Core.

Esempi

File runtimeconfig.json:

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

File runtimeconfig.template.json:

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

File di progetto:

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

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

</Project>

Intervalli di anni dell'era

• Determina se i controlli di intervallo per i calendari che supportano più ere sono poco rigorosi o se le date che superano l'intervallo di date di un'era generano una ArgumentOutOfRangeException.
• Se si omette questa impostazione, i controlli di intervallo sono poco rigorosi. Equivale a impostare il valore su false.
• Per altre informazioni, vedere Calendari, ere e intervalli di date: controlli di intervallo poco rigorosi.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Analisi di una data giapponese

• Determina se una stringa che contiene "1" o "Gannen" come anno viene analizzata correttamente o se è supportato solo "1".
• Se si omette questa impostazione, le stringhe che contengono "1" o "Gannen" come anno vengono analizzate correttamente. Equivale a impostare il valore su false.
• Per altre informazioni, vedere Rappresentare le date nei calendari con più ere.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Formato anno giapponese

• Determina se il primo anno di un'era del calendario giapponese è formattato come "Gannen" o come numero.
• Se si omette questa impostazione, il primo anno viene formattato come "Gannen". Equivale a impostare il valore su false.
• Per altre informazioni, vedere Rappresentare le date nei calendari con più ere.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

NLS

• Determina se .NET usa API per la globalizzazione NLS (National Language Support) o ICU (International Components for Unicode) per le app Windows. .NET 5 e versioni successive usano le API per la globalizzazione ICU per impostazione predefinita in Aggiornamento di Windows 10 (maggio 2019) e versioni successive.
• Se si omette questa impostazione, .NET usa le API per la globalizzazione ICU per impostazione predefinita. Equivale a impostare il valore su false.
• Per altre informazioni, vedere Le API per la globalizzazione usano librerie ICU in Windows.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Impostazioni cultura predefinite

• Configura se le app possono creare impostazioni cultura diverse dalle impostazioni cultura inglese non dipendenti da paese/area geografica quando è abilitata la modalità invariante per la globalizzazione.
• Se si omette questa impostazione, .NET limita la creazione di impostazioni cultura in modalità invariante per la globalizzazione. Equivale a impostare il valore su true.
• Per altre informazioni, vedere Creazione di impostazioni cultura e mapping dei casi nella modalità invariante per la globalizzazione.