| 属性 | 值 |
|---|---|
| 规则 ID | CA1708 |
| 标题 | 标识符的区分应不仅限于大小写的不同 |
| 类别 | 命名 |
| 修复会引起中断还是不会引起中断 | 突发 |
| 在 .NET 10 中默认启用 | 否 |
| 适用的语言 | C# 和 Visual Basic |
原因
两种类型、成员、参数或完全限定的命名空间的名称转换为小写时是相同的。
默认情况下,此规则仅查看外部可见的类型、成员和命名空间,但这是可配置的。
规则说明
不能仅通过大小写区分命名空间、类型、成员和参数的标识符,因为面向公共语言运行时的语言无需区分大小写。 例如,Visual Basic 是一种广泛使用的不区分大小写的语言。
如何解决违规
选择一个在与其他标识符进行不区分大小写的比较时仍然具有唯一性的名称。
何时禁止显示警告
不要抑制此规则发出的警告。 库可能无法用于 .NET 中的所有可用语言。
配置代码以进行分析
使用下面的选项来配置代码库的哪些部分要运行此规则。
可以仅为此规则、为适用的所有规则或为适用的此类别(命名)中的所有规则配置此选项。 有关详细信息,请参阅代码质量规则配置选项。
包含特定的 API 图面
你可以通过设置 api_surface 选项来配置要基于可访问性对代码库的哪些部分运行此规则。 例如,若要指定规则应仅针对非公共 API 图面运行,请将以下键值对添加到项目中的 .editorconfig 文件:
dotnet_code_quality.CAXXXX.api_surface = private, internal
注意
将 XXXX 的 CAXXXX 部分替换为适用规则的 ID。
违规示例
下面的示例演示与此规则发生冲突的情况。
public class Class1
{
protected string someName;
public string SomeName => someName;
}
以下示例演示的是解决违规的一种方法
public class Class1
{
protected string _someName;
public string SomeName => _someName;
}