CA1859：尽可能使用具体类型来提高性能

属性	值
规则 ID	CA1859
标题	尽可能使用具体类型以提高性能
类别	“性能”
修复是中断修复还是非中断修复	非中断
引入的版本	.NET 8
在 .NET 8 中默认启用	作为建议

原因

代码使用接口类型或抽象类型，导致不必要的接口调用或虚拟调用。

规则说明

此规则建议尽可能将特定局部变量、字段、属性、方法参数和方法返回类型从接口或抽象类型升级到具体类型。 使用具体类型可最大程度地减少虚拟或接口调度开销并启用内联，从而生成更高质量的代码。

此规则仅在存在实际可以通过使用具体类型避免的虚拟调用或接口调用时报告冲突。

如何解决冲突

按照规则的建议升级类型。 通常，更改类型不会影响代码的行为，但可以提高其性能。

示例

以下代码片段演示了 CA1859 冲突：

abstract class A
{
    public virtual void M() { }
}

sealed class B : A
{ }

internal class C
{
    private readonly A _a = new B();

    public void Trigger()
    {
        // This performs a virtual call because
        // _a is defined as an abstract class.
        _a.M();
    }
}

以下代码片段修复了冲突：

abstract class A
{
    public virtual void M() { }
}

sealed class B : A
{ }

internal class C
{
    private readonly B _b = new B();

    public void Trigger()
    {
        _b.M();
    }
}

何时禁止显示警告

如果不考虑性能，则可以安全地禁止显示警告。

抑制警告

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

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

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

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

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