Share via

CA2008：不要在未传递 TaskScheduler 的情况下创建任务

  • 项目
属性 值
规则 ID CA2008
标题 不要在未传递 TaskScheduler 的情况下创建任务
类别 可靠性
修复是中断修复还是非中断修复 非中断
在 .NET 8 中默认启用 否

原因

任务创建或延续操作使用未指定 TaskScheduler 参数的方法重载。

规则说明

以下 .NET 任务创建和延续方法具有允许指定或省略 TaskScheduler 实例的重载：

始终指定显式 TaskScheduler 参数以避免默认 Current 值，其行为由调用方定义并且在运行时可能会变化。 Current 返回与该线程上当前运行的任何 Task 相关联的计划程序。 如果没有此类任务，则返回 Default，它表示线程池。 在某些情况下，使用 Current 可能会导致死锁或 UI 响应问题，因为原本打算在线程池上创建任务，但却等待返回到 UI 线程。

有关详细信息和详细示例，请参阅 .NET Framework 4.5 中的新 TaskCreationOptions 和 TaskContinuationOptions。

注意

VSTHRD105 - 避免使用假定 TaskScheduler.Current 是在 Microsoft.VisualStudio.Threading.Analyzers 包中实现的类似规则的方法重载。

如何解决冲突

若要解决冲突，请调用接受 TaskScheduler 并显式传入 Default 或 Current 以使意图明确的方法重载。

何时禁止显示警告

此警告主要针对库，在库中，代码可能会在任意环境中执行，并且代码不应该对环境或方法的调用方如何调用或等待作出假设。 对于代表应用程序代码（而不是库代码）的项目，可禁止显示此警告。

抑制警告

如果只想抑制单个冲突，请将预处理器指令添加到源文件以禁用该规则，然后重新启用该规则。

#pragma warning disable CA2008
// The code that's violating the rule is on this line.
#pragma warning restore CA2008

若要对文件、文件夹或项目禁用该规则，请在配置文件中将其严重性设置为 none。

[*.{cs,vb}]
dotnet_diagnostic.CA2008.severity = none

有关详细信息，请参阅如何禁止显示代码分析警告。

另请参阅