İş parçacığı oluşturma için çalışma zamanı yapılandırma seçenekleri

Bu makalede, .NET'te iş parçacığını yapılandırmak için kullanabileceğiniz ayarlar ayrıntılı olarak anlatılır.

Windows'ta tüm CPU gruplarını kullanma

Birden çok CPU grubuna sahip makinelerde bu ayar, iş parçacığı havuzu gibi bileşenlerin tüm CPU gruplarını mı yoksa işlemin yalnızca birincil CPU grubunu mu kullandığını yapılandırılır. Bu ayar, döndürenleri Environment.ProcessorCount de etkiler.
Bu ayar etkinleştirildiğinde tüm CPU grupları kullanılır ve iş parçacıkları da varsayılan olarak CPU grupları arasında otomatik olarak dağıtılır .
Bu ayar Windows 11 ve sonraki sürümlerde varsayılan olarak etkinleştirilir ve Windows 10 ve önceki sürümlerde varsayılan olarak devre dışı bırakılır. Bu ayarın etkinleştirildiğinde etkili olması için GC'nin de tüm CPU gruplarını kullanacak şekilde yapılandırılması gerekir; daha fazla bilgi için bkz. GC CPU grupları.

	Ayarın adı	Değerler
runtimeconfig.json	Yok	Yok
Ortam değişkeni	`DOTNET_Thread_UseAllCpuGroups`	`0` -sakat `1` -Etkin

Windows'ta CPU gruplarına iş parçacığı atama

Birden çok CPU grubuna ve tüm CPU gruplarına sahip makinelerde bu ayar, iş parçacıklarının CPU grupları arasında otomatik olarak dağıtılıp dağıtılmayacağını yapılandırılır.
Bu ayar etkinleştirildiğinde, yeni iş parçacıkları yeni bir CPU grubu kullanılmadan önce zaten kullanımda olan bir CPU grubunu tam olarak doldurmaya çalışacak şekilde bir CPU grubuna atanır.
Bu ayar varsayılan olarak etkindir.

	Ayarın adı	Değerler
runtimeconfig.json	Yok	Yok
Ortam değişkeni	`DOTNET_Thread_AssignCpuGroups`	`0` -sakat `1` -Etkin

Minimum iş parçacıkları

Çalışan iş parçacığı havuzu için en az iş parçacığı sayısını belirtir.
yöntemine ThreadPool.SetMinThreads karşılık gelir.

	Ayarın adı	Değerler
runtimeconfig.json	`System.Threading.ThreadPool.MinThreads`	En az iş parçacığı sayısını temsil eden bir tamsayı
MSBuild özelliği	`ThreadPoolMinThreads`	En az iş parçacığı sayısını temsil eden bir tamsayı
Ortam değişkeni	Yok	Yok

Örnekler

runtimeconfig.json dosyası:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.MinThreads": 4
      }
   }
}

runtimeconfig.template.json dosyası:

{
   "configProperties": {
      "System.Threading.ThreadPool.MinThreads": 4
   }
}

Proje dosyası:

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

  <PropertyGroup>
    <ThreadPoolMinThreads>4</ThreadPoolMinThreads>
  </PropertyGroup>

</Project>

En fazla iş parçacığı sayısı

Çalışan iş parçacığı havuzu için en fazla iş parçacığı sayısını belirtir.
yöntemine ThreadPool.SetMaxThreads karşılık gelir.

	Ayarın adı	Değerler
runtimeconfig.json	`System.Threading.ThreadPool.MaxThreads`	İş parçacığı sayısı üst sınırını temsil eden bir tamsayı
MSBuild özelliği	`ThreadPoolMaxThreads`	İş parçacığı sayısı üst sınırını temsil eden bir tamsayı
Ortam değişkeni	Yok	Yok

Örnekler

runtimeconfig.json dosyası:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.MaxThreads": 20
      }
   }
}

runtimeconfig.template.json dosyası:

{
   "configProperties": {
      "System.Threading.ThreadPool.MaxThreads": 20
   }
}

Proje dosyası:

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

  <PropertyGroup>
    <ThreadPoolMaxThreads>20</ThreadPoolMaxThreads>
  </PropertyGroup>

</Project>

Windows iş parçacığı havuzu

Windows'da projeler için, iş parçacığı havuzu iş parçacığı yönetiminin Windows iş parçacığı havuzuna temsilci olarak atanıp atanmayacağını yapılandırılır.
Bu ayarı atlarsanız veya platform Windows değilse, bunun yerine .NET iş parçacığı havuzu kullanılır.
Yalnızca Windows'da Yerel AOT ile yayımlanan uygulamalar varsayılan olarak Windows iş parçacığı havuzunu kullanır. Yapılandırma ayarını devre dışı bırakarak bunun yerine .NET iş parçacığı havuzunu kullanmayı tercih edebilirsiniz.
Windows iş parçacığı havuzu, en az iş parçacığı sayısının yüksek bir değere yapılandırıldığı veya Windows iş parçacığı havuzunun uygulama tarafından zaten yoğun olarak kullanıldığı durumlarda daha iyi performans gösterebilir. .NET iş parçacığı havuzunun daha büyük makinelerde ağır G/Ç işleme gibi daha iyi performans gösterdiği durumlar da olabilir. Bu yapılandırma ayarını değiştirirken performans ölçümlerini denetlemesi önerilir.
Windows iş parçacığı havuzu kullanılırken , ThreadPool.SetMaxThreadsve ThreadPool.BindHandle(SafeHandle)gibi ThreadPool.SetMinThreadsbazı API'ler desteklenmez. En düşük ve en yüksek iş parçacıkları için iş parçacığı havuzu yapılandırma ayarları da etkili değildir. bunun alternatifi ThreadPool.BindHandle(SafeHandle)ThreadPoolBoundHandle sınıfıdır.

	Ayarın adı	Değerler	Sürüm kullanıma sunulmuştur
runtimeconfig.json	`System.Threading.ThreadPool.UseWindowsThreadPool`	`true` -Etkin `false` -sakat	.NET 8
MSBuild özelliği	`UseWindowsThreadPool`	`true` -Etkin `false` -sakat	.NET 8
Ortam değişkeni	`DOTNET_ThreadPool_UseWindowsThreadPool`	`1` -Etkin `0` -sakat	.NET 8

Örnekler

runtimeconfig.json dosyası:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.UseWindowsThreadPool": true
      }
   }
}

runtimeconfig.template.json dosyası:

{
   "configProperties": {
      "System.Threading.ThreadPool.UseWindowsThreadPool": true
   }
}

Proje dosyası:

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

  <PropertyGroup>
    <UseWindowsThreadPool>true</UseWindowsThreadPool>
  </PropertyGroup>

</Project>

İş öğelerini engellemeye yanıt olarak iş parçacığı ekleme

Bazı durumlarda, iş parçacığı havuzu iş parçacıklarını engelleyen iş öğelerini algılar. Telafi etmek için daha fazla iş parçacığı ekler. .NET 6+'da, iş öğelerini engellemeye yanıt olarak iş parçacığı eklemeyi yapılandırmak için aşağıdaki çalışma zamanı yapılandırma ayarlarını kullanabilirsiniz. Şu anda, bu ayarlar yalnızca başka bir görevin tamamlanmasını bekleyen iş öğeleri için (örneğin, zaman uyumsuz eşitleme durumlarında) etkili olur.

runtimeconfig.json ayar adı	Description	Sürüm kullanıma sunulmuştur
`System.Threading.ThreadPool.Blocking.ThreadsToAddWithoutDelay_ProcCountFactor`	temel alınan `MinThreads` iş parçacığı sayısına ulaşıldıktan sonra bu değer (işlemci sayısıyla çarpıldıktan sonra) gecikme olmadan kaç ek iş parçacığı oluşturulabileceğini belirtir.	.NET 6
`System.Threading.ThreadPool.Blocking.ThreadsPerDelayStep_ProcCountFactor`	temel alınan `ThreadsToAddWithoutDelay` iş parçacığı sayısına ulaşıldıktan sonra, bu değer (işlemci sayısıyla çarpıldıktan sonra) her yeni iş parçacığı oluşturulmadan önce gecikmeye kaç iş parçacığı `DelayStepMs` ekleneceğini belirtir.	.NET 6
`System.Threading.ThreadPool.Blocking.DelayStepMs`	temel alan `ThreadsToAddWithoutDelay` iş parçacığı sayısına ulaşıldıktan sonra bu değer, her yeni iş parçacığı oluşturulmadan önce uygulanacak olan iş parçacıkları başına `ThreadsPerDelayStep` ne kadar ek gecikme ekleneceğini belirtir.	.NET 6
`System.Threading.ThreadPool.Blocking.MaxDelayMs`	temel alan `ThreadsToAddWithoutDelay` iş parçacığı sayısına ulaşıldıktan sonra, bu değer her yeni iş parçacığı oluşturulmadan önce kullanılacak en uzun gecikmeyi belirtir.	.NET 6
`System.Threading.ThreadPool.Blocking.IgnoreMemoryUsage`	Varsayılan olarak, engellemeye yanıt olarak iş parçacığı ekleme hızı, kullanılabilir yeterli fiziksel bellek olup olmadığını belirleyen buluşsal yöntemlerle sınırlıdır. Bazı durumlarda, düşük bellekli durumlarda bile iş parçacıklarını daha hızlı bir şekilde eklemek tercih edilebilir. Bu anahtarı kapatarak bellek kullanımı buluşsal özelliklerini devre dışı bırakabilirsiniz.	.NET 7

Yapılandırma ayarları nasıl geçerlilik kazanır?

temel alan MinThreads iş parçacığı sayısına ulaşıldıktan sonra, gecikme olmadan en fazla ThreadsToAddWithoutDelay ek iş parçacığı oluşturulabilir.
Bundan sonra, her ek iş parçacığı oluşturulmadan önce ile başlayan DelayStepMsbir gecikme oluşur.
Gecikmeli olarak eklenen her ThreadsPerDelayStep iş parçacığı için gecikmeye bir ek DelayStepMs eklenir.
Gecikme aşılamayabilir MaxDelayMs.
Gecikmeler yalnızca iş parçacıkları oluşturulmadan önce oluşturulur. İş parçacıkları zaten kullanılabilir durumdaysa, iş öğelerini engellemeyi telafi etmek için gecikme olmadan serbest bırakılırlar.
Fiziksel bellek kullanımı ve sınırları da kullanılır ve bir eşiğin ötesinde sistem daha yavaş iş parçacığı eklemeye geçer.

Örnekler

runtimeconfig.json dosyası:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.ThreadPool.Blocking.ThreadsToAddWithoutDelay_ProcCountFactor": 5
      }
   }
}

runtimeconfig.template.json dosyası:

{
   "configProperties": {
      "System.Threading.ThreadPool.Blocking.ThreadsToAddWithoutDelay_ProcCountFactor": 5
   }
}

`AutoreleasePool` yönetilen iş parçacıkları için

Bu seçenek, desteklenen bir macOS platformunda çalıştırılırken her yönetilen iş parçacığının örtük bir NSAutoreleasePool alıp almayacağını yapılandırıyor.

	Ayarın adı	Değerler	Sürüm kullanıma sunulmuştur
runtimeconfig.json	`System.Threading.Thread.EnableAutoreleasePool`	`true` veya `false`	.NET 6
MSBuild özelliği	`AutoreleasePoolSupport`	`true` veya `false`	.NET 6
Ortam değişkeni	Yok	Yok	Yok

Örnekler

runtimeconfig.json dosyası:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Threading.Thread.EnableAutoreleasePool": true
      }
   }
}

runtimeconfig.template.json dosyası:

{
   "configProperties": {
      "System.Threading.Thread.EnableAutoreleasePool": true
   }
}

Proje dosyası:

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

  <PropertyGroup>
    <AutoreleasePoolSupport>true</AutoreleasePoolSupport>
  </PropertyGroup>

</Project>

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-11-22

İş parçacığı oluşturma için çalışma zamanı yapılandırma seçenekleri

Windows'ta tüm CPU gruplarını kullanma

Windows'ta CPU gruplarına iş parçacığı atama

Minimum iş parçacıkları

Örnekler

En fazla iş parçacığı sayısı

Örnekler

Windows iş parçacığı havuzu

Örnekler

İş öğelerini engellemeye yanıt olarak iş parçacığı ekleme

Yapılandırma ayarları nasıl geçerlilik kazanır?

Örnekler

AutoreleasePool yönetilen iş parçacıkları için

Örnekler

Geri Bildirim

Ek kaynaklar

`AutoreleasePool` yönetilen iş parçacıkları için