CA1820:使用字符串长度测试是否有空字符串

属性	值
规则 ID	CA1820
标题	使用字符串长度测试是否有空字符串
类别	“性能”
修复是中断修复还是非中断修复	非中断
在 .NET 9 中默认启用	否

原因

使用了 Object.Equals 将字符串与空字符串进行比较。

规则说明

使用 String.Length 属性或 String.IsNullOrEmpty 方法比较字符串比使用 Equals 更快。 这是因为 Equals 执行的 CIL 指令比 IsNullOrEmpty 执行或执行以检索 Length 属性值的指令数要多得多，并将其与零进行比较。

对于 NULL 字符串，Equals 和 <string>.Length == 0 的行为不同。 如果尝试获取 NULL 字符串的 Length 属性值，则公共语言运行时将引发 System.NullReferenceException。 如果在 NULL 字符串和空字符串之间执行比较，则公共语言运行时不会引发异常，并将返回 false。 测试 NULL 不会对这两种方法的相对性能产生显著影响。 面向 .NET Framework 2.0 或更高版本时，请使用 IsNullOrEmpty 方法。 否则，请尽可能使用 Length == 0 比较。

如何解决冲突

若要解决此规则的冲突，请更改比较以使用 IsNullOrEmpty 方法。

何时禁止显示警告

如果性能不是问题，可禁止显示此规则的警告。

抑制警告

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

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

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

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

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

示例

下面的示例演示了用于查找空字符串的不同技术。

public class StringTester
{
    string s1 = "test";

    public void EqualsTest()
    {
        // Violates rule: TestForEmptyStringsUsingStringLength.
        if (s1 == "")
        {
            Console.WriteLine("s1 equals empty string.");
        }
    }

    // Use for .NET Framework 1.0 and 1.1.
    public void LengthTest()
    {
        // Satisfies rule: TestForEmptyStringsUsingStringLength.
        if (s1 != null && s1.Length == 0)
        {
            Console.WriteLine("s1.Length == 0.");
        }
    }

    // Use for .NET Framework 2.0.
    public void NullOrEmptyTest()
    {
        // Satisfies rule: TestForEmptyStringsUsingStringLength.
        if (!String.IsNullOrEmpty(s1))
        {
            Console.WriteLine("s1 != null and s1.Length != 0.");
        }
    }
}