Laufzeitkonfigurationsoptionen für das Threading

Artikel
10/07/2023

In diesem Artikel werden die Einstellungen beschrieben, mit denen Sie das Threading in .NET konfigurieren können.

Hinweis

In .NET 6 ist das Präfix DOTNET_ statt COMPlus_ Standard für Umgebungsvariablen, die das .NET-Runtimeverhalten konfigurieren. Das Präfix COMPlus_ funktioniert jedoch weiterhin. Wenn Sie eine frühere Version der .NET-Runtime verwenden, sollten Sie weiterhin das Präfix COMPlus_ für Umgebungsvariablen verwenden.

Verwenden aller CPU-Gruppen unter Windows

Auf Computern mit mehreren CPU-Gruppen konfiguriert diese Einstellung, ob Komponenten wie der Threadpool alle CPU-Gruppen oder nur die primäre CPU-Gruppe des Prozesses verwenden. Die Einstellung wirkt sich auch darauf aus, was Environment.ProcessorCount zurückgibt.
Wenn diese Einstellung aktiviert ist, werden alle CPU-Gruppen verwendet, und Threads werden ebenfalls standardmäßig automatisch über CPU-Gruppen verteilt.
Diese Einstellung ist standardmäßig unter Windows 11 und höheren Versionen aktiviert und standardmäßig unter Windows 10 und früheren Versionen deaktiviert. Damit diese Einstellung wirksam wird, wenn sie aktiviert ist, muss die GC auch so konfiguriert sein, dass alle CPU-Gruppen verwendet werden. Weitere Informationen finden Sie unter CPU-Gruppen für die Garbage Collection.

	Einstellungsname	Werte
runtimeconfig.json	Nicht zutreffend	Nicht zutreffend
Umgebungsvariable	`COMPlus_Thread_UseAllCpuGroups` oder `DOTNET_Thread_UseAllCpuGroups`	`0` – deaktiviert `1` – aktiviert

Zuweisen von Threads zu CPU-Gruppen unter Windows

Auf Computern mit mehreren CPU-Gruppen und wenn alle CPU-Gruppen verwendet werden, konfiguriert diese Einstellung, ob Threads automatisch über CPU-Gruppen verteilt werden.
Wenn diese Einstellung aktiviert ist, werden einer CPU-Gruppe neue Threads auf eine Weise zugewiesen, bei der versucht wird, eine bereits verwendete CPU-Gruppe vollständig aufzufüllen, bevor eine neue CPU-Gruppe verwendet wird.
Diese Einstellung ist standardmäßig aktiviert.

	Einstellungsname	Werte
runtimeconfig.json	Nicht zutreffend	Nicht zutreffend
Umgebungsvariable	`COMPlus_Thread_AssignCpuGroups` oder `DOTNET_Thread_AssignCpuGroups`	`0` – deaktiviert `1` – aktiviert

Mindestanzahl an Threads

Gibt die Mindestanzahl an Threads für den Arbeitsthreadpool an.
Entspricht der ThreadPool.SetMinThreads-Methode

	Einstellungsname	Werte
runtimeconfig.json	`System.Threading.ThreadPool.MinThreads`	Eine ganze Zahl, die die Mindestanzahl an Threads angibt
MSBuild-Eigenschaft	`ThreadPoolMinThreads`	Eine ganze Zahl, die die Mindestanzahl an Threads angibt
Umgebungsvariable	Nicht zutreffend	Nicht zutreffend

Beispiele

runtimeconfig.json-Datei:

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

runtimeconfig.template.json-Datei:

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

Projektdatei:

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

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

</Project>

Maximale Anzahl an Threads

Gibt die maximale Anzahl an Threads für den Arbeitsthreadpool an.
Entspricht der ThreadPool.SetMaxThreads-Methode

	Einstellungsname	Werte
runtimeconfig.json	`System.Threading.ThreadPool.MaxThreads`	Eine ganze Zahl, die die maximale Anzahl der Threads darstellt
MSBuild-Eigenschaft	`ThreadPoolMaxThreads`	Eine ganze Zahl, die die maximale Anzahl der Threads darstellt
Umgebungsvariable	Nicht zutreffend	Nicht zutreffend

Beispiele

runtimeconfig.json-Datei:

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

runtimeconfig.template.json-Datei:

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

Projektdatei:

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

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

</Project>

Windows-Threadpool

Bei Projekten unter Windows wird konfiguriert, ob die Threadverwaltung des Threadpools an den Windows-Threadpool delegiert wird.
Wenn Sie diese Einstellung weglassen oder die Plattform nicht Windows ist, wird stattdessen der .NET-Threadpool verwendet.
Nur Anwendungen, die mit nativem AOT unter Windows veröffentlicht wurden, verwenden standardmäßig den Windows-Threadpool, für den Sie stattdessen den .NET-Threadpool nutzen können, indem Sie die Konfigurationseinstellung deaktivieren.
Der Windows-Threadpool kann in einigen Fällen besser ausgeführt werden, z. B. in Fällen, in denen die Mindestanzahl von Threads auf einen hohen Wert konfiguriert ist, oder wenn der Windows-Threadpool bereits stark von der App verwendet wird. Es kann auch Fälle geben, in denen der .NET-Threadpool besser ausgeführt wird, z. B. bei einer hohen E/A-Verarbeitung auf größeren Computern. Es ist ratsam, Leistungsmetriken beim Ändern dieser Konfigurationseinstellung zu überprüfen.
Einige APIs werden nicht unterstützt, wenn Sie den Windows-Threadpool verwenden, z. B. ThreadPool.SetMinThreads, ThreadPool.SetMaxThreads und ThreadPool.BindHandle(SafeHandle). Die Konfigurationseinstellungen des Threadpools für minimale und maximale Threads sind ebenfalls nicht effektiv. Eine Alternative zu ThreadPool.BindHandle(SafeHandle) ist die Klasse ThreadPoolBoundHandle.

	Einstellungsname	Werte	Eingeführt in Version
runtimeconfig.json	`System.Threading.ThreadPool.UseWindowsThreadPool`	`true` – aktiviert `false` – deaktiviert	.NET 8
MSBuild-Eigenschaft	`UseWindowsThreadPool`	`true` – aktiviert `false` – deaktiviert	.NET 8
Umgebungsvariable	`DOTNET_ThreadPool_UseWindowsThreadPool`	`1` – aktiviert `0` – deaktiviert	.NET 8

Beispiele

runtimeconfig.json-Datei:

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

runtimeconfig.template.json-Datei:

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

Projektdatei:

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

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

</Project>

Threadinjektion als Reaktion auf blockierende Arbeitselemente

In einigen Fällen erkennt der Threadpool Arbeitselemente, die seine Threads blockieren. Um dies auszugleichen, fügt er weitere Threads ein. In .NET 6 und höher können Sie die folgenden Einstellungen zur Laufzeitkonfiguration verwenden, um die Threadinjektion als Reaktion auf blockierende Arbeitselemente zu konfigurieren. Derzeit werden diese Einstellungen nur für Arbeitselemente wirksam, die auf den Abschluss einer anderen Aufgabe warten, z. B. in typischen Sync-over-Async-Fällen.

Name der runtimeconfig.json-Einstellung	BESCHREIBUNG	Eingeführt in Version
`System.Threading.ThreadPool.Blocking.ThreadsToAddWithoutDelay_ProcCountFactor`	Nachdem die Threadanzahl gemäß `MinThreads` erreicht wurde, gibt dieser Wert (nachdem er mit der Prozessoranzahl multipliziert wurde) an, wie viele zusätzliche Threads ohne Verzögerung erstellt werden können.	.NET 6
`System.Threading.ThreadPool.Blocking.ThreadsPerDelayStep_ProcCountFactor`	Nachdem die Threadanzahl gemäß `ThreadsToAddWithoutDelay` erreicht wurde, gibt dieser Wert (nachdem er mit der Prozessoranzahl multipliziert wurde) an, nach wie vielen Threads der Verzögerung ein weiterer `DelayStepMs`-Wert hinzugefügt wird, bevor die einzelnen neuen Threads erstellt werden.	.NET 6
`System.Threading.ThreadPool.Blocking.DelayStepMs`	Nachdem die Threadanzahl gemäß `ThreadsToAddWithoutDelay` erreicht wurde, gibt dieser Wert an, wie viel zusätzliche Verzögerung pro `ThreadsPerDelayStep`-Thread hinzugefügt werden muss und vor dem Erstellen der einzelnen neuen Threads angewendet wird.	.NET 6
`System.Threading.ThreadPool.Blocking.MaxDelayMs`	Nachdem die Threadanzahl gemäß `ThreadsToAddWithoutDelay` erreicht wurde, gibt dieser Wert die maximale Verzögerung an, die vor dem Erstellen der einzelnen neuen Threads angewendet werden soll.	.NET 6
`System.Threading.ThreadPool.Blocking.IgnoreMemoryUsage`	Standardmäßig ist die Rate der Threadinjektion als Reaktion auf die Blockierung durch Heuristiken begrenzt. Diese bestimmen, ob genügend physischer Arbeitsspeicher verfügbar ist. In manchen Situationen wird teilweise bevorzugt, Threads auch in Situationen mit geringem Arbeitsspeicher schneller zu injizieren. Sie können die Heuristiken für die Speicherauslastung deaktivieren, indem Sie diese Option deaktivieren.	.NET 7

Inkrafttreten der Konfigurationseinstellungen

Nachdem die Threadanzahl gemäß MinThreads erreicht wurde, können bis zu ThreadsToAddWithoutDelay zusätzliche Threads ohne Verzögerung erstellt werden.
Danach wird vor der Erstellung jedes weiteren Threads eine Verzögerung ausgelöst, beginnend mit DelayStepMs.
Für alle ThreadsPerDelayStep-Threads, die mit einer Verzögerung hinzugefügt werden, wird der Verzögerung ein zusätzlicher DelayStepMs-Wert hinzugefügt.
Die Verzögerung darf MaxDelayMs nicht überschreiten.
Verzögerungen werden nur vor dem Erstellen von Threads ausgelöst. Wenn Threads bereits verfügbar sind, werden sie ohne Verzögerung freigegeben, um blockierende Arbeitselemente auszugleichen.
Außerdem werden die Nutzungs- und Grenzwerte für physischen Arbeitsspeicher angewendet, und ab einem bestimmten Schwellenwert wechselt das System zu einer langsameren Threadinjektion.

Beispiele

runtimeconfig.json-Datei:

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

runtimeconfig.template.json-Datei:

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

`AutoreleasePool` für verwaltete Threads

Mit dieser Option wird konfiguriert, ob jeder verwaltete Thread bei Ausführung auf einer unterstützten macOS-Plattform einen impliziten NSAutoreleasePool empfängt.

	Einstellungsname	Werte	Eingeführt in Version
runtimeconfig.json	`System.Threading.Thread.EnableAutoreleasePool`	`true` oder `false`	.NET 6
MSBuild-Eigenschaft	`AutoreleasePoolSupport`	`true` oder `false`	.NET 6
Umgebungsvariable	Nicht zutreffend	Nicht zutreffend	Nicht zutreffend

Beispiele

runtimeconfig.json-Datei:

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

runtimeconfig.template.json-Datei:

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

Projektdatei:

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

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

</Project>

Teilen über

Laufzeitkonfigurationsoptionen für das Threading

Verwenden aller CPU-Gruppen unter Windows

Zuweisen von Threads zu CPU-Gruppen unter Windows

Mindestanzahl an Threads

Beispiele

Maximale Anzahl an Threads

Beispiele

Windows-Threadpool

Beispiele

Threadinjektion als Reaktion auf blockierende Arbeitselemente

Inkrafttreten der Konfigurationseinstellungen

Beispiele

`AutoreleasePool` für verwaltete Threads

Beispiele

Zusätzliche Ressourcen

Teilen über

Laufzeitkonfigurationsoptionen für das Threading

Verwenden aller CPU-Gruppen unter Windows

Zuweisen von Threads zu CPU-Gruppen unter Windows

Mindestanzahl an Threads

Beispiele

Maximale Anzahl an Threads

Beispiele

Windows-Threadpool

Beispiele

Threadinjektion als Reaktion auf blockierende Arbeitselemente

Inkrafttreten der Konfigurationseinstellungen

Beispiele

AutoreleasePool für verwaltete Threads

Beispiele

Zusätzliche Ressourcen

`AutoreleasePool` für verwaltete Threads