Teilen über

Laufzeitkonfigurationsoptionen für globalisierung

Invarianter Modus

  • Bestimmt, ob eine .NET Core-App im Globalisierungs-invarianten Modus ohne Zugriff auf kulturspezifische Daten und Verhalten ausgeführt wird.
  • Wenn Sie diese Einstellung weglassen, wird die App mit Zugriff auf Kulturdaten ausgeführt. Dies entspricht der Einstellung des Werts auf false.
  • Weitere Informationen finden Sie im .NET Core-Globalisierungsmodus.
Einstellungsname Werte
runtimeconfig.json System.Globalization.Invariant false - Zugang zu Kulturdaten
true - Im invarianten Modus ausführen
MSBuild-Eigenschaft InvariantGlobalization false - Zugang zu Kulturdaten
true - Im invarianten Modus ausführen
Umgebungsvariable DOTNET_SYSTEM_GLOBALIZATION_INVARIANT 0 - Zugang zu Kulturdaten
1 - Im invarianten Modus ausführen

Examples

runtimeconfig.json-Datei:

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

runtimeconfig.template.json-Datei:

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

Projektdatei:

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

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

</Project>

Bereiche des Era year

Einstellungsname Werte
runtimeconfig.json Switch.System.Globalization.EnforceJapaneseEraYearRanges false - Entspannte Bereichsprüfungen
true - Überläufe verursachen eine Ausnahme
Umgebungsvariable N/A N/A

Diese Konfigurationseinstellung verfügt nicht über eine bestimmte MSBuild-Eigenschaft. Sie können jedoch stattdessen ein RuntimeHostConfigurationOption-MSBuild-Element hinzufügen. Verwenden Sie den Einstellungsnamen runtimeconfig.json als Wert des Include-Attributs. Ein Beispiel finden Sie unter MSBuild-Eigenschaften.

Japanische Datumsanalyse

  • Bestimmt, ob eine Zeichenfolge, die entweder "1" oder "Gannen" als Jahresparsen enthält, erfolgreich oder ob nur "1" unterstützt wird.
  • Wenn Sie diese Einstellung weglassen, werden Zeichenfolgen, die entweder "1" oder "Gannen" enthalten, als Jahresanalyse erfolgreich verwendet. Dies entspricht der Einstellung des Werts auf false.
  • Weitere Informationen finden Sie unter Darstellen von Datumsangaben in Kalendern mit mehreren Epochen.
Einstellungsname Werte
runtimeconfig.json Switch.System.Globalization.EnforceLegacyJapaneseDateParsing false - "Gannen" oder "1" wird unterstützt
true - nur "1" wird unterstützt.
Umgebungsvariable N/A N/A

Diese Konfigurationseinstellung verfügt nicht über eine bestimmte MSBuild-Eigenschaft. Sie können jedoch stattdessen ein RuntimeHostConfigurationOption-MSBuild-Element hinzufügen. Verwenden Sie den Einstellungsnamen runtimeconfig.json als Wert des Include-Attributs. Ein Beispiel finden Sie unter MSBuild-Eigenschaften.

Japanisches Jahresformat

  • Bestimmt, ob das erste Jahr einer japanischen Kalenderzeit als "Gannen" oder als Zahl formatiert ist.
  • Wenn Sie diese Einstellung weglassen, wird das erste Jahr als "Gannen" formatiert. Dies entspricht der Einstellung des Werts auf false.
  • Weitere Informationen finden Sie unter Darstellen von Datumsangaben in Kalendern mit mehreren Epochen.
Einstellungsname Werte
runtimeconfig.json Switch.System.Globalization.FormatJapaneseFirstYearAsANumber false - Format als "Gannen"
true - Format als Zahl
Umgebungsvariable N/A N/A

Diese Konfigurationseinstellung verfügt nicht über eine bestimmte MSBuild-Eigenschaft. Sie können jedoch stattdessen ein RuntimeHostConfigurationOption-MSBuild-Element hinzufügen. Verwenden Sie den Einstellungsnamen runtimeconfig.json als Wert des Include-Attributs. Ein Beispiel finden Sie unter MSBuild-Eigenschaften.

NLS

  • Bestimmt, ob .NET National Language Support (NLS) oder internationale Komponenten für Unicode(ICU)-Globalisierungs-APIs für Windows-Apps verwendet. .NET 5 und höhere Versionen verwenden standardmäßig ICU-Globalisierungs-APIs unter Windows 10 Mai 2019 Update und höher.
  • Wenn Sie diese Einstellung weglassen, verwendet .NET standardmäßig ICU-Globalisierungs-APIs. Dies entspricht der Einstellung des Werts auf false.
  • Weitere Informationen finden Sie unter Globalisierungs-APIs, die ICU-Bibliotheken unter Windows verwenden.
Einstellungsname Werte Eingeführt
runtimeconfig.json System.Globalization.UseNls false - Verwenden von ICU-Globalisierungs-APIs
true - Verwenden von NLS-Globalisierungs-APIs		 .NET 5
Umgebungsvariable DOTNET_SYSTEM_GLOBALIZATION_USENLS false - Verwenden von ICU-Globalisierungs-APIs
true - Verwenden von NLS-Globalisierungs-APIs		 .NET 5

Diese Konfigurationseinstellung verfügt nicht über eine bestimmte MSBuild-Eigenschaft. Sie können jedoch stattdessen ein RuntimeHostConfigurationOption-MSBuild-Element hinzufügen. Verwenden Sie den Einstellungsnamen runtimeconfig.json als Wert des Include-Attributs. Ein Beispiel finden Sie unter MSBuild-Eigenschaften.

Vordefinierte Kulturen

Einstellungsname Werte Eingeführt
runtimeconfig.json System.Globalization.PredefinedCulturesOnly true - Im globalisierungsinvarianten Modus dürfen Sie keine Kultur mit Ausnahme der invarianten Kultur schaffen.
false - Die Schaffung einer beliebigen Kultur zulassen.		 .NET 6
MSBuild-Eigenschaft PredefinedCulturesOnly true - Im globalisierungsinvarianten Modus dürfen Sie keine Kultur mit Ausnahme der invarianten Kultur schaffen.
false - Die Schaffung einer beliebigen Kultur zulassen.		 .NET 6
Umgebungsvariable DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY true - Im globalisierungsinvarianten Modus dürfen Sie keine Kultur mit Ausnahme der invarianten Kultur schaffen.
false - Die Schaffung einer beliebigen Kultur zulassen.		 .NET 6
  • Last updated on