Параметры конфигурации времени выполнения для потоков

В этой статье подробно описаны параметры, которые можно использовать для настройки потоков в .NET.

Использование всех групп ЦП в Windows

• На компьютерах с несколькими группами ЦП этот параметр настраивает, используют ли такие компоненты, как пул потоков, все группы ЦП или только основную группу ЦП процесса. Параметр также влияет на то, что Environment.ProcessorCount возвращается.
• Если этот параметр включен, все группы ЦП используются и потоки также автоматически распределяются между группами ЦП по умолчанию.
• Этот параметр включен по умолчанию в Windows 11 и более поздних версиях и отключен по умолчанию в Windows 10 и более ранних версиях. Чтобы этот параметр вступают в силу при включении, сборка GC также должна быть настроена для использования всех групп ЦП; Дополнительные сведения см. в группах ЦП GC.

Назначение потоков группам ЦП в Windows

• На компьютерах с несколькими группами ЦП и всеми группами ЦП используются, этот параметр настраивает, распределяются ли потоки автоматически между группами ЦП.
• Если этот параметр включен, новые потоки назначаются группе ЦП таким образом, чтобы пытаться полностью заполнить группу ЦП, которая уже используется перед использованием новой группы ЦП.
• Этот флажок устанавливается по умолчанию.

Минимальное число потоков

• Указывает минимальное число потоков для рабочего пула потоков.
• Соответствует методу ThreadPool.SetMinThreads.

Примеры

Файл runtimeconfig.json

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

файл runtimeconfig.template.json :

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

Файл проекта:

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

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

</Project>

Максимальное число потоков

• Указывает максимальное число потоков для рабочего пула потоков.
• Соответствует методу ThreadPool.SetMaxThreads.

Примеры

Файл runtimeconfig.json

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

файл runtimeconfig.template.json :

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

Файл проекта:

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

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

</Project>

Пул потоков Windows

• Для проектов в Windows настраивается ли управление потоками пула потоков в пул потоков Windows.
• Если этот параметр не указан или платформа не windows, вместо этого используется пул потоков .NET.
• Только приложения, опубликованные в машинном режиме AOT в Windows, используют пул потоков Windows по умолчанию, для которого можно использовать пул потоков .NET, отключив параметр конфигурации.
• Пул потоков Windows может улучшиться в некоторых случаях, например в тех случаях, когда минимальное количество потоков настроено на высокое значение или когда пул потоков Windows уже используется приложением. Также могут возникнуть случаи, когда пул потоков .NET работает лучше, например при интенсивной обработке операций ввода-вывода на больших компьютерах. Рекомендуется проверка метрики производительности при изменении этого параметра конфигурации.
• Некоторые API не поддерживаются при использовании пула потоков Windows, например ThreadPool.SetMinThreads, ThreadPool.SetMaxThreadsи ThreadPool.BindHandle(SafeHandle). Параметры конфигурации пула потоков для минимальных и максимальных потоков также не эффективны. ThreadPool.BindHandle(SafeHandle) Альтернативой ThreadPoolBoundHandle является класс.

Примеры

Файл runtimeconfig.json

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

файл runtimeconfig.template.json :

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

Файл проекта:

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

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

</Project>

Внедрение потока в ответ на блокировку рабочих элементов

В некоторых случаях пул потоков обнаруживает, что некоторые рабочие элементы блокируют его потоки. Чтобы компенсировать эту потерю, он внедряет дополнительные потоки. В .NET 6 и более поздних версий вы можете использовать указанные ниже параметры конфигурации среды выполнения, чтобы настроить внедрение потока в ответ на блокировку рабочих элементов. Сейчас эти параметры действуют только для тех рабочих элементов, которые ожидают завершения другой задачи. Типичным примером такого поведения является выполнение синхронных операций через асинхронные.

Как применяются эти параметры конфигурации

• Когда число потоков достигает ограничения MinThreads, без задержки могут быть созданы ThreadsToAddWithoutDelay дополнительных потоков.
• После этого перед созданием каждого следующего потока добавляется задержка, начиная с DelayStepMs.
• После каждых ThreadsPerDelayStep потоков, добавленных с задержкой, значение задержки увеличивается на DelayStepMs.
• Значение задержки не может превышать MaxDelayMs.
• Эти задержки применяются только перед созданием потоков. Если готовые потоки уже доступны, они без всяких задержек выделяются для компенсации потерь, связанных с блокировкой рабочих элементов.
• Также применяются ограничения на использование физической памяти, а сверх указанного предела система переходит на более медленное внедрение потоков.

Примеры

Файл runtimeconfig.json

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

файл runtimeconfig.template.json :

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

AutoreleasePool для управляемых потоков

Этот параметр определяет, получает ли каждый управляемый поток неявный экземпляр NSAutoreleasePool при запуске на поддерживаемой платформе macOS.

Примеры

Файл runtimeconfig.json

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

файл runtimeconfig.template.json :

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

Файл проекта:

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

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

</Project>