CA1513：使用 ObjectDisposedException 辅助抛出函数

原因

代码检查对象是否已释放，然后按条件引发 ObjectDisposedException。

规则说明

对象检查对代码大小有重大影响，并且通常支配着小型函数和属性资源库的代码。 这些检查会阻止内联，并造成重大的指令缓存污染。 引发辅助方法如 ThrowIf 比构造新异常实例的 if 块更简单且更高效。

示例

以下代码片段显示了对 CA1513 的违规：

class C
{
    private bool _disposed = false;
    void M()
    {
        if (_disposed)
            throw new ObjectDisposedException(GetType().Name);
    }
}

以下代码片段显示了修复方法：

class C
{
    private bool _disposed = false;
    void M()
    {
        ObjectDisposedException.ThrowIf(_disposed, this);
    }
}

如何解决违规

将引发异常的 if 块替换为对 ThrowIf 的调用。 或者，在 Visual Studio 中，使用灯泡菜单自动修复代码。

何时禁止显示警告

如果不关心代码的可维护性，可以安全地忽略此规则的违例。 还可以抑制标识为误报的违规行为。

抑制警告

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

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

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

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

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