CA1849：当在异步方法中时，调用异步方法

  • 项目
属性 值
规则 ID CA1849
标题 当在异步方法中时，调用异步方法
类别 “性能”
修复是中断修复还是非中断修复 非中断
在 .NET 8 中默认启用 否

原因

从任务返回方法调用时，存在 Async 后缀等效项的所有方法都会生成此警告。 此外，调用 Task.Wait()、Task<T>.Result 或 Task.GetAwaiter().GetResult() 将生成此警告。

规则说明

在已属于异步的方法中，对其他方法的调用应指向其存在的异步版本。

如何解决冲突

冲突：

Task DoAsync()
{
    file.Read(buffer, 0, 10);
}

修复：

等待方法的异步版本：

async Task DoAsync()
{
    await file.ReadAsync(buffer, 0, 10);
}

何时禁止显示警告

在同步和异步代码有两个单独的代码路径的情况下，使用 if 条件抑制来自此规则的警告很安全。 此外，如果要检查任务是否已解决，则使用同步方法和属性很安全。

抑制警告

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

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

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

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

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

另请参阅