Genelleştirme için çalışma zamanı yapılandırma seçenekleri

  • Makale

Sabit mod

  • Bir .NET Core uygulamasının kültüre özgü verilere ve davranışlara erişim olmadan genelleştirme sabit modunda çalışıp çalışmayacağını belirler.
  • Bu ayarı atlarsanız uygulama kültürel verilere erişimle çalışır. Bu, değerini falseolarak ayarlamakla eşdeğerdir.
  • Daha fazla bilgi için bkz . .NET Core genelleştirme sabit modu.
Ayar adı Değerler
runtimeconfig.json System.Globalization.Invariant false - kültürel verilere erişim
true - sabit modda çalıştır
MSBuild özelliği InvariantGlobalization false - kültürel verilere erişim
true - sabit modda çalıştır
Ortam değişkeni DOTNET_SYSTEM_GLOBALIZATION_INVARIANT 0 - kültürel verilere erişim
1 - sabit modda çalıştır

Örnekler

runtimeconfig.json dosyası:

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

runtimeconfig.template.json dosyası:

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

Proje dosyası:

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

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

</Project>

Dönem yılı aralıkları

Ayar adı Değerler
runtimeconfig.json Switch.System.Globalization.EnforceJapaneseEraYearRanges false - gevşek aralık denetimleri
true - taşmalar özel duruma neden oluyor
Ortam değişkeni Geçersiz Geçersiz

Bu yapılandırma ayarı belirli bir MSBuild özelliğine sahip değil. Ancak, bunun yerine bir RuntimeHostConfigurationOption MSBuild öğesi ekleyebilirsiniz. Özniteliğin değeri Include olarak runtimeconfig.json ayar adını kullanın. Bir örnek için bkz . MSBuild özellikleri.

Japonca tarih ayrıştırma

  • Yıl olarak "1" veya "Gannen" içeren bir dizenin başarıyla ayrıştırılıp ayrıştırılmadığını veya yalnızca "1" desteklenip desteklenmediğini belirler.
  • Bu ayarı atlarsanız, yıl olarak "1" veya "Gannen" içeren dizeler başarıyla ayrıştırılmış olur. Bu, değerini falseolarak ayarlamakla eşdeğerdir.
  • Daha fazla bilgi için bkz . Birden çok dönemi olan takvimlerde tarihleri temsil edin.
Ayar adı Değerler
runtimeconfig.json Switch.System.Globalization.EnforceLegacyJapaneseDateParsing false - "Gannen" veya "1" desteklenir
true - yalnızca "1" desteklenir
Ortam değişkeni Geçersiz Geçersiz

Bu yapılandırma ayarı belirli bir MSBuild özelliğine sahip değil. Ancak, bunun yerine bir RuntimeHostConfigurationOption MSBuild öğesi ekleyebilirsiniz. Özniteliğin değeri Include olarak runtimeconfig.json ayar adını kullanın. Bir örnek için bkz . MSBuild özellikleri.

Japonca yıl biçimi

  • Japon takvim döneminin ilk yılının "Gannen" olarak mı yoksa sayı olarak mı biçimlendirileceğini belirler.
  • Bu ayarı atlarsanız, ilk yıl "Gannen" olarak biçimlendirilir. Bu, değerini falseolarak ayarlamakla eşdeğerdir.
  • Daha fazla bilgi için bkz . Birden çok dönemi olan takvimlerde tarihleri temsil edin.
Ayar adı Değerler
runtimeconfig.json Switch.System.Globalization.FormatJapaneseFirstYearAsANumber false - "Gannen" olarak biçimlendirme
true - sayı olarak biçimlendir
Ortam değişkeni Geçersiz Geçersiz

Bu yapılandırma ayarı belirli bir MSBuild özelliğine sahip değil. Ancak, bunun yerine bir RuntimeHostConfigurationOption MSBuild öğesi ekleyebilirsiniz. Özniteliğin değeri Include olarak runtimeconfig.json ayar adını kullanın. Bir örnek için bkz . MSBuild özellikleri.

NLS

  • .NET'in, Windows uygulamaları için Unicode (ICU) genelleştirme API'leri için Ulusal Dil Desteği (NLS) veya Uluslararası Bileşenler kullanıp kullanmadığını belirler. .NET 5 ve sonraki sürümleri, Windows 10 Mayıs 2019 Güncelleştirmesi ve sonraki sürümlerde varsayılan olarak ICU genelleştirme API'lerini kullanır.
  • Bu ayarı atlarsanız, .NET varsayılan olarak ICU genelleştirme API'lerini kullanır. Bu, değerini falseolarak ayarlamakla eşdeğerdir.
  • Daha fazla bilgi için bkz . Genelleştirme API'leri Windows'ta ICU kitaplıklarını kullanır.
Ayar adı Değerler Sunulan özellikler
runtimeconfig.json System.Globalization.UseNls false - ICU genelleştirme API'lerini kullanma
true - NLS genelleştirme API'lerini kullanma		 .NET 5
Ortam değişkeni DOTNET_SYSTEM_GLOBALIZATION_USENLS false - ICU genelleştirme API'lerini kullanma
true - NLS genelleştirme API'lerini kullanma		 .NET 5

Bu yapılandırma ayarı belirli bir MSBuild özelliğine sahip değil. Ancak, bunun yerine bir RuntimeHostConfigurationOption MSBuild öğesi ekleyebilirsiniz. Özniteliğin değeri Include olarak runtimeconfig.json ayar adını kullanın. Bir örnek için bkz . MSBuild özellikleri.

Önceden tanımlanmış kültürler

  • Genelleştirme sabit modu etkinleştirildiğinde uygulamaların sabit kültür dışında kültürler oluşturup oluşturamayacağını yapılandırır.
  • Bu ayarı atlarsanız, .NET genelleştirme sabit modunda kültürlerin oluşturulmasını kısıtlar. Bu, değerini trueolarak ayarlamakla eşdeğerdir.
  • Daha fazla bilgi için bkz . Genelleştirme sabit modunda kültür oluşturma ve büyük/küçük harf eşleme.
Ayar adı Değerler Sunulan özellikler
runtimeconfig.json System.Globalization.PredefinedCulturesOnly true - Genelleştirme sabit modunda sabit kültür dışında herhangi bir kültürün oluşturulmasına izin verme.
false - Herhangi bir kültürün oluşturulmasına izin verin.		 .NET 6
MSBuild özelliği PredefinedCulturesOnly true - Genelleştirme sabit modunda sabit kültür dışında herhangi bir kültürün oluşturulmasına izin verme.
false - Herhangi bir kültürün oluşturulmasına izin verin.		 .NET 6
Ortam değişkeni DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY true - Genelleştirme sabit modunda sabit kültür dışında herhangi bir kültürün oluşturulmasına izin verme.
false - Herhangi bir kültürün oluşturulmasına izin verin.		 .NET 6