Dela via

Konfigurationsalternativ för körning för globalisering

Invariant läge

  • Avgör om en .NET Core-app körs i globaliseringsvariant läge utan åtkomst till kulturspecifika data och beteende.
  • Om du utelämnar den här inställningen körs appen med åtkomst till kulturella data. Detta motsvarar att ange värdet till false.
  • Mer information finns i .NET Core-globalisering ivariant läge.
Inställningsnamn Värden
runtimeconfig.json System.Globalization.Invariant false - tillgång till kulturella data
true – kör i invariant läge
MSBuild-egenskap InvariantGlobalization false - tillgång till kulturella data
true – kör i invariant läge
Miljövariabel DOTNET_SYSTEM_GLOBALIZATION_INVARIANT 0 - tillgång till kulturella data
1 – kör i invariant läge

Examples

runtimeconfig.json fil:

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

runtimeconfig.template.json fil:

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

Projektfil:

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

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

</Project>

Intervall för eraår

Inställningsnamn Värden
runtimeconfig.json Switch.System.Globalization.EnforceJapaneseEraYearRanges false - avspänna intervallkontroller
true – spill orsakar ett undantag
Miljövariabel N/A N/A

Den här konfigurationsinställningen har ingen specifik MSBuild-egenskap. Du kan dock lägga till ett RuntimeHostConfigurationOption MSBuild-objekt i stället. Använd runtimeconfig.json inställningsnamnet som värdet för attributetInclude. Ett exempel finns i MSBuild-egenskaper.

Japansk datumparsing

  • Avgör om en sträng som innehåller antingen "1" eller "Gannen" som året parsar korrekt eller om endast "1" stöds.
  • Om du utelämnar den här inställningen parsas strängar som innehåller antingen "1" eller "Gannen" som året. Detta motsvarar att ange värdet till false.
  • Mer information finns i Representera datum i kalendrar med flera epoker.
Inställningsnamn Värden
runtimeconfig.json Switch.System.Globalization.EnforceLegacyJapaneseDateParsing false – "Gannen" eller "1" stöds
true – endast "1" stöds
Miljövariabel N/A N/A

Den här konfigurationsinställningen har ingen specifik MSBuild-egenskap. Du kan dock lägga till ett RuntimeHostConfigurationOption MSBuild-objekt i stället. Använd runtimeconfig.json inställningsnamnet som värdet för attributetInclude. Ett exempel finns i MSBuild-egenskaper.

Japanskt årsformat

  • Avgör om det första året i en japansk kalendertid formateras som "Gannen" eller som ett tal.
  • Om du utelämnar den här inställningen formateras det första året som "Gannen". Detta motsvarar att ange värdet till false.
  • Mer information finns i Representera datum i kalendrar med flera epoker.
Inställningsnamn Värden
runtimeconfig.json Switch.System.Globalization.FormatJapaneseFirstYearAsANumber false - formatera som "Gannen"
true - formatera som tal
Miljövariabel N/A N/A

Den här konfigurationsinställningen har ingen specifik MSBuild-egenskap. Du kan dock lägga till ett RuntimeHostConfigurationOption MSBuild-objekt i stället. Använd runtimeconfig.json inställningsnamnet som värdet för attributetInclude. Ett exempel finns i MSBuild-egenskaper.

NLS

  • Avgör om .NET använder NATIONAL Language Support (NLS) eller International Components for Unicode (ICU) globaliserings-API:er för Windows-appar. .NET 5 och senare versioner använder ICU-globaliserings-API:er som standard i Windows 10 Maj 2019 Update och senare versioner.
  • Om du utelämnar den här inställningen använder .NET ICU-globaliserings-API:er som standard. Detta motsvarar att ange värdet till false.
  • Mer information finns i Globaliserings-API:er använder ICU-bibliotek i Windows.
Inställningsnamn Värden Introducerade
runtimeconfig.json System.Globalization.UseNls false – Använda API:er för ICU-globalisering
true – Använda NLS-globaliserings-API:er		 .NET 5
Miljövariabel DOTNET_SYSTEM_GLOBALIZATION_USENLS false – Använda API:er för ICU-globalisering
true – Använda NLS-globaliserings-API:er		 .NET 5

Den här konfigurationsinställningen har ingen specifik MSBuild-egenskap. Du kan dock lägga till ett RuntimeHostConfigurationOption MSBuild-objekt i stället. Använd runtimeconfig.json inställningsnamnet som värdet för attributetInclude. Ett exempel finns i MSBuild-egenskaper.

Fördefinierade kulturer

Inställningsnamn Värden Introducerade
runtimeconfig.json System.Globalization.PredefinedCulturesOnly true – I globaliserings-invariant läge ska du inte tillåta skapande av någon kultur förutom den invarianta kulturen.
false - Tillåt skapandet av vilken kultur som helst.		 .NET 6
MSBuild-egenskap PredefinedCulturesOnly true – I globaliserings-invariant läge ska du inte tillåta skapande av någon kultur förutom den invarianta kulturen.
false - Tillåt skapandet av vilken kultur som helst.		 .NET 6
Miljövariabel DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY true – I globaliserings-invariant läge ska du inte tillåta skapande av någon kultur förutom den invarianta kulturen.
false - Tillåt skapandet av vilken kultur som helst.		 .NET 6
  • Last updated on