CA1849:当在异步方法中时,调用异步方法
属性 | 值 |
---|---|
规则 ID | CA1849 |
标题 | 当在异步方法中时,调用异步方法 |
类别 | “性能” |
修复是中断修复还是非中断修复 | 非中断 |
在 .NET 9 中默认启用 | 否 |
原因
从任务返回方法调用时,存在 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
有关详细信息,请参阅如何禁止显示代码分析警告。