ReSharper 2025.2 Help

代码检查:自动属性可以设为仅 get(非私有访问性)

从 C# 6.0 开始,您可以定义仅 get 的自动属性,这些属性(类似于 只读字段 )只能通过构造函数或初始化器进行初始化。 ReSharper 会检测并帮助您移除在构造函数/初始化器中初始化且没有写入使用的自动属性上的冗余 设值 访问器。

在下面的示例中,意图是创建一个不可变类,并且一旦在构造函数中检查了 名称 属性的可空性,就可以安全地使用它,而无需进一步的空检查。 然而,私有 setter 并不能保证该属性不会在私有成员中被更改。 因此,最好将此属性设为仅 get,以防止任何修改。

public class Person { public string Name { get; set; } // Auto-property can be made get-only public Person(string name) { Name = name ?? throw new ArgumentNullException(nameof(name)); } public override string ToString() { return $"NAME: {Name.ToUpper()}"; } }

要使解决方案范围的检查生效,您需要启用以下至少一项:

  • 简化的全局使用检查:在 ReSharper 选项 Alt+R, O 代码检查 | 设置 页面上选择 当解决方案范围分析关闭时,显示未使用的非私有类型成员

  • 解决方案范围分析 :在 ReSharper 选项 的 代码检查 | 设置 页面上选择 启用解决方案级分析(_A) Alt+R, O

请注意,即使报告的属性 setter 在您的解决方案中没有直接用法,也可能存在间接使用的情况——例如,通过反射——或者它可能只是设计为公共 API。 在所有这些情况下,您可能希望通过以下方式之一 抑制属性 setter 的用法检查:

  • 推荐的方法是用 代码注解属性装饰隐式使用的属性 setter。 为此有两个属性: [UsedImplicitly][PublicAPI] ,它们在功能上相似,但可以让您和您的团队成员了解属性 setter 的实际使用方式。

  • 您还可以使用任何自定义属性抑制使用检查。 为此,请使用 [MeansImplicitUse]属性标记该属性的定义。

  • 最后,您可以像对待任何其他代码检查一样,通过 抑制注释或抑制属性来抑制特定的使用检查。

最后修改日期: 2025年 9月 27日