用于线程的运行时配置选项

本文详细介绍了可用于在 .NET 中配置线程处理的设置。

在 Windows 上使用所有 CPU 组

• 在具有多个 CPU 组的计算机上，此设置将配置线程池等组件是使用所有 CPU 组还是仅使用进程的主 CPU 组。 该设置还会影响返回的内容 Environment.ProcessorCount 。
• 启用此设置后，将使用所有 CPU 组，并且默认情况下线程也会 自动分布在 CPU 组中 。
• 此设置默认在 Windows 11 及更高版本上启用，默认情况下在 Windows 10 及更低版本上禁用。 为了使此设置在启用时生效，还必须将 GC 配置为使用所有 CPU 组;有关详细信息，请参阅 GC CPU 组。

将线程分配到 Windows 上的 CPU 组

• 在使用多个 CPU 组和 所有 CPU 组的计算机上，此设置将配置线程是否自动分布在 CPU 组中。
• 启用此设置后，新线程会以尝试在使用新 CPU 组之前完全填充已使用的 CPU 组的方式分配给 CPU 组。
• 默认情况下，此设置处于启用状态。

最小线程数

• 指定工作线程池的最小线程数。
• 对应于 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 线程池。
• 默认情况下，只有使用 Windows 上的本机 AOT 发布的应用程序使用 Windows 线程池，你可以选择改用 .NET 线程池，方法是禁用配置设置。
• 在某些情况下，Windows 线程池的性能可能更好，例如，如果将最小线程数配置为高值，或者当应用大量使用 Windows 线程池时。 在某些情况下，.NET 线程池的性能更好，例如在较大的计算机上执行大量 I/O 处理。 建议在更改此配置设置时检查性能指标。
• 使用 Windows 线程池（例如 ThreadPool.SetMinThreads， ThreadPool.SetMaxThreads和 ThreadPool.BindHandle(SafeHandle)）时不支持某些 API。 最小和最大线程的线程池配置设置也无效。 类的替代 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 用于托管线程

此选项配置每个托管线程在受支持的 macOS 平台上运行时是否接收隐式 NSAutoreleasePool 。

例子

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>