CA1511:使用 ArgumentException 引发帮助程序

属性
规则 ID CA1511
标题 使用 ArgumentException 引发帮助程序
类别 可维护性
修复是中断修复还是非中断修复 非中断
在 .NET 8 中默认启用 作为建议

原因

代码检查参数是 null 还是空字符串,然后有条件地引发 ArgumentException

规则说明

参数检查对代码大小有重大影响,并且通常支配着小型函数和属性资源库的代码。 这些检查会阻止内联,并造成重大的指令缓存污染。 与构造新异常实例的 if 块相比,ArgumentException.ThrowIfNullOrEmpty(String, String) 等引发帮助程序方法更简单高效。

示例

以下代码片段显示了违反 CA1511 的情况:

void M(string arg)
{
    if (string.IsNullOrEmpty(arg))
        throw new ArgumentException("", "arg");
}

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

void M(string arg)
{
    ArgumentException.ThrowIfNullOrEmpty(arg);
}

如何解决冲突

将引发异常的 if 块替换为对 ArgumentException.ThrowIfNullOrEmpty(String, String) 的调用。 或者,在 Visual Studio 中,使用灯泡菜单自动修复代码。

何时禁止显示警告

如果不在乎代码的可维护性,可安全地禁止显示此规则的冲突。 还可以禁止显示标识为误报的冲突。

抑制警告

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

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

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

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

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