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

Makale
11/14/2023

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ı

Birden çok dönemi destekleyen takvimler için aralık denetimlerinin gevşetilip gevşetileceğini veya bir dönemin tarih aralığını aşan tarihlerin bir oluşturup oluşturmadığını ArgumentOutOfRangeExceptionbelirler.
Bu ayarı atlarsanız, aralık denetimleri gevşetilir. Bu, değerini falseolarak ayarlamakla eşdeğerdir.
Daha fazla bilgi için bkz . Takvimler, dönemler ve tarih aralıkları: Gevşek aralık denetimleri.

	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

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

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

Ö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

Aracılığıyla paylaş